{"id":48985253,"url":"https://github.com/backrunner/start-claude","last_synced_at":"2026-04-18T12:11:04.467Z","repository":{"id":308218942,"uuid":"1031870652","full_name":"backrunner/start-claude","owner":"backrunner","description":"A powerful CLI tool to manage and start Claude Code with different configurations and load balancer / API transformers","archived":false,"fork":false,"pushed_at":"2026-01-15T06:53:04.000Z","size":2074,"stargazers_count":30,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T13:05:22.586Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/backrunner.png","metadata":{"files":{"readme":"README_zh.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-04T13:04:26.000Z","updated_at":"2026-01-15T06:53:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"cd2fb061-3abe-4f71-b49b-dc9594c22fea","html_url":"https://github.com/backrunner/start-claude","commit_stats":null,"previous_names":["backrunner/start-claude"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/backrunner/start-claude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backrunner%2Fstart-claude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backrunner%2Fstart-claude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backrunner%2Fstart-claude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backrunner%2Fstart-claude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/backrunner","download_url":"https://codeload.github.com/backrunner/start-claude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backrunner%2Fstart-claude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31968143,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-18T12:11:02.706Z","updated_at":"2026-04-18T12:11:04.456Z","avatar_url":"https://github.com/backrunner.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# start-claude\n\n一个强大的 CLI 工具，用于管理和启动具有不同配置的 Claude Code。轻松管理多个 Claude 配置、通过 S3 同步到各个设备，并通过美观的交互式界面在它们之间切换。\n\n## 特性\n\n- 🚀 **轻松配置管理**：添加、编辑、删除和列出 Claude 配置\n- 🔧 **环境变量支持**：完全支持所有 35+ 个 Claude Code 环境变量\n- ⚡ **CLI 覆盖**：直接从命令行覆盖 API 密钥、模型、基础 URL 和设置自定义环境变量\n- 📦 **自动安装**：自动检测并安装缺失的 Claude Code CLI\n- ☁️ **S3 同步**：智能跨设备同步，支持冲突检测和修改时间跟踪\n- 🎨 **现代 Web 界面**：美观、响应式的配置管理器，支持实时搜索和拖放\n- ⚖️ **高级负载均衡器**：智能负载均衡，支持健康监控、自动故障转移和可配置设置\n- 🔄 **转换器支持**：在不同 AI API 格式之间转换（OpenAI、自定义提供商）\n- 💻 **命令覆盖**：Windows 兼容的 shell 别名，采用双脚本+别名方法\n- 🌐 **多提供商支持**：在负载均衡中混合匹配不同的 AI 提供商\n\n## 快速开始\n\n**🚀 无需设置！** 立即开始使用：\n\n```bash\n# 全局安装\nnpm install -g start-claude\n# 或\npnpm add -g start-claude\n\n# 直接使用 CLI 覆盖启动 Claude Code（无需配置）\nstart-claude --api-key sk-your-key --model claude-sonnet-4-5-20250929\n\n# 使用短命令别名\nscc --api-key sk-your-key --model claude-sonnet-4-5-20250929\n\n# Windows 用户：启用覆盖以获得更好的兼容性\nstart-claude override\n\n# 对于持久配置，交互式添加一个\nstart-claude add\n\n# 打开现代 Web 界面\nstart-claude manager\n```\n\n## 基本用法\n\n```bash\n# 基本命令\nstart-claude                    # 使用默认配置启动\nstart-claude \u003cconfig\u003e           # 使用特定配置启动\nstart-claude list              # 列出所有配置\nstart-claude add               # 添加新配置\nstart-claude edit \u003cname\u003e       # 编辑配置\n\n# 现代 Web 界面\nstart-claude manager          # 打开基于 Web 的配置管理器\n\n# 带健康监控的高级负载均衡器\nstart-claude --balance         # 使用系统默认平衡设置启动\nstart-claude --balance --verbose  # 启用详细健康检查日志\n\n# CLI 覆盖（无需配置）\nstart-claude --api-key sk-key --model claude-sonnet-4-5-20250929\nstart-claude -e DEBUG=1 -e NODE_ENV=prod --verbose\n\n# 带智能冲突检测的 S3 同步\nstart-claude s3 setup          # 配置带时间戳跟踪的 S3 同步\nstart-claude s3 sync           # 带冲突解决的智能同步\nstart-claude s3 upload --force # 强制上传（忽略时间戳警告）\nstart-claude s3 download       # 带时间戳比较的下载\n\n# 覆盖原始 claude-code 命令\nstart-claude override         # 启用 claude 命令覆盖\nstart-claude override disable # 禁用覆盖\nstart-claude override status  # 检查覆盖状态\nstart-claude override shells  # 显示支持的 shell\n```\n\n## 现代 Web 界面\n\nStart Claude 现在包含一个美观、现代的配置管理 Web 界面：\n\n- **🎨 现代设计**：简洁、基于渐变的 UI，支持暗模式\n- **🔍 实时搜索**：即时过滤配置\n- **📱 拖放**：带视觉反馈的配置重新排序\n- **⚙️ 系统设置**：集中式平衡模式和 S3 同步偏好\n- **✅ 智能验证**：带详细错误消息的实时验证\n- **🌓 暗模式**：自动系统主题检测\n\n```bash\n# 启动 Web 界面\nstart-claude manager\n# 在 http://localhost:3000 打开你的配置\n```\n\n## 高级负载均衡器\n\n带智能健康监控的增强负载均衡：\n\n- **🏥 健康监控**：可配置的健康检查间隔\n- **🚫 智能故障转移**：自动端点禁用和恢复\n- **⚙️ 系统集成**：通过 Web 界面或系统设置配置\n- **📊 详细日志**：全面的健康检查和故障转移日志\n\n### 平衡模式设置\n\n通过 Web 界面（`start-claude manager`）或系统设置进行配置：\n\n- **默认启用**：自动以平衡模式启动\n- **健康检查间隔**：自定义监控频率（10秒 - 5分钟）\n- **失败端点处理**：自动禁用持续时间（1分钟 - 1小时）\n- **禁用健康检查**：使用带端点禁用的简单轮询\n  start-claude -e DEBUG=1 -e NODE_ENV=prod --verbose\n\n## 短别名\n\nscc --api-key sk-key --model claude-3-haiku\n\n## 编辑器模式\n\n在你喜欢的编辑器中编辑配置：\n\n```bash\nstart-claude add -e             # 在编辑器中创建配置\nstart-claude edit myconfig -e   # 在编辑器中编辑配置\nstart-claude edit-config        # 直接编辑配置文件，支持实时重载\n```\n\n## Claude Code 文档\n\n有关 Claude Code CLI 的完整信息：\n\n**📖 [Claude Code 文档](https://docs.anthropic.com/en/docs/claude-code)**\n\n## 贡献\n\n我们欢迎贡献！查看我们的[开发指南](docs/zh/development.md)了解详情：\n\n- 设置开发环境\n- 运行测试\n- 代码风格指导\n- 提交流程\n\n## 许可证\n\nMIT 许可证\n\n## 致谢\n\n本项目整合并基于多个优秀的开源工具：\n\n- **[llms](https://github.com/musistudio/llms)** - Claude Code Router Core Service\n- **[ccusage](https://github.com/LouisShark/ccusage)** - 全面的 Claude Code 使用分析和成本跟踪工具\n- **[ccstatusline](https://github.com/LouisShark/ccstatusline)** - Shell 和编辑器的实时 Claude Code 状态行集成\n\n```\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackrunner%2Fstart-claude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbackrunner%2Fstart-claude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackrunner%2Fstart-claude/lists"}