{"id":43388534,"url":"https://github.com/dobestone/cc-switch-cli","last_synced_at":"2026-03-13T13:04:53.418Z","repository":{"id":336019848,"uuid":"1147895873","full_name":"DoBestone/cc-switch-cli","owner":"DoBestone","description":"纯命令行版本的 CC-Switch，用于在 Linux 服务器上管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的供应商配置","archived":false,"fork":false,"pushed_at":"2026-02-02T12:31:45.000Z","size":80,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-02T23:38:51.029Z","etag":null,"topics":["ai-tools","claude","cli","codex","command-line","gemini","linux","rust","server"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DoBestone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-02-02T10:35:36.000Z","updated_at":"2026-02-02T12:31:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DoBestone/cc-switch-cli","commit_stats":null,"previous_names":["dobestone/cc-switch-cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/DoBestone/cc-switch-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoBestone%2Fcc-switch-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoBestone%2Fcc-switch-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoBestone%2Fcc-switch-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoBestone%2Fcc-switch-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DoBestone","download_url":"https://codeload.github.com/DoBestone/cc-switch-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DoBestone%2Fcc-switch-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29092984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai-tools","claude","cli","codex","command-line","gemini","linux","rust","server"],"created_at":"2026-02-02T12:27:02.829Z","updated_at":"2026-03-13T13:04:53.385Z","avatar_url":"https://github.com/DoBestone.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CC-Switch CLI\n\n[![Release](https://img.shields.io/github/v/release/DoBestone/cc-switch-cli?include_prereleases)](https://github.com/DoBestone/cc-switch-cli/releases)\n[![License](https://img.shields.io/github/license/DoBestone/cc-switch-cli)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-blue)](https://github.com/DoBestone/cc-switch-cli/releases)\n\n纯命令行版本的 CC-Switch，用于在 Linux 服务器（无图形界面）上管理 Claude Code、Codex、Gemini CLI、OpenClaw 等 AI 编程工具的供应商配置。\n\n\u003e **📢 致谢说明**\n\u003e 本项目基于 [farion1231/cc-switch](https://github.com/farion1231/cc-switch) 进行二次开发。\n\u003e 原项目是一个功能完善的图形界面工具，本项目将其重构为纯命令行版本，以适配 Linux 服务器环境。\n\u003e 感谢原作者 [@farion1231](https://github.com/farion1231) 的优秀工作！\n\n## ✨ 特性\n\n### 核心功能\n- 🖥️ **纯 CLI** - 无 GUI 依赖，可在 SSH 会话中使用\n- 🎮 **交互式菜单** - 新手友好的图形化菜单界面（支持高级 TUI 模式）\n- 🔄 **供应商切换** - 快速切换不同的 API 供应商配置\n- 📋 **多应用支持** - Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw\n\n### 供应商管理\n- 🧪 **API 测试** - 验证 API Key 有效性和连接延迟\n- 📦 **MCP 服务器管理** - 管理 Model Context Protocol 服务器\n- 📝 **Prompts 管理** - 管理系统提示词（CLAUDE.md 等）\n- 🧩 **Skills 扩展** - 从 GitHub 安装和管理 Skills\n- 🔄 **批量操作** - 批量切换、测试、导出、导入、同步和编辑供应商\n- 🔥 **故障转移** - 配置备用供应商，主供应商失败时自动切换\n\n### 网络与代理\n- 🌐 **代理支持** - 全局代理设置和自动扫描\n- ⚡ **端点测速** - 测试 API 端点延迟\n- 🔍 **环境检测** - 检测环境变量冲突\n\n### 云端与统计\n- ☁️ **WebDAV 同步** - 配置云端同步，多设备配置共享\n- 📊 **使用量统计** - 查看 API 使用量和限额管理\n\n### Web 与更新\n- 🌐 **Web 控制器** - 通过浏览器管理配置（带身份验证）\n- 🚀 **智能更新** - 自动检测新版本，支持大/中/小版本更新策略\n  - 🔴 大版本更新：强制提示，需用户确认\n  - 🟡 中版本更新：推荐更新\n  - 🟢 小版本更新：选择性更新\n\n### 其他\n- 💾 **单一可执行文件** - 编译后仅需一个二进制文件\n- 🛡️ **SHA256 校验** - 下载文件完整性验证\n\n## 📥 安装\n\n### 🚀 一键安装（推荐）\n\n```bash\n# 使用 curl\ncurl -fsSL https://raw.githubusercontent.com/DoBestone/cc-switch-cli/main/install.sh | bash\n\n# 或使用 wget\nwget -qO- https://raw.githubusercontent.com/DoBestone/cc-switch-cli/main/install.sh | bash\n```\n\n安装脚本会自动：\n1. 检测您的操作系统和架构\n2. 下载预编译二进制（支持 SHA256 校验）\n3. 如果没有预编译版本，自动安装 Rust 并从源码编译\n4. 将 `cc-switch` 安装到 `/usr/local/bin`\n\n### 🔄 更新到最新版\n\n```bash\n# 方式一：使用内置命令更新（推荐）\ncc-switch self-update\n\n# 检查更新但不安装\ncc-switch self-update --check\n\n# 强制重新安装最新版\ncc-switch self-update --force\n\n# 方式二：使用更新脚本\ncurl -fsSL https://raw.githubusercontent.com/DoBestone/cc-switch-cli/main/update.sh | bash\n```\n\n**高级选项：**\n\n```bash\n# 指定安装特定版本\nCC_SWITCH_VERSION=1.2.3 bash \u003c(curl -fsSL https://raw.githubusercontent.com/DoBestone/cc-switch-cli/main/update.sh)\n\n# 强制重新安装\nCC_SWITCH_FORCE=1 bash \u003c(curl -fsSL https://raw.githubusercontent.com/DoBestone/cc-switch-cli/main/update.sh)\n\n# 跳过 SHA256 校验（不推荐）\nCC_SWITCH_NO_VERIFY=1 bash \u003c(curl -fsSL https://raw.githubusercontent.com/DoBestone/cc-switch-cli/main/update.sh)\n```\n\n### 📦 支持的平台\n\n| 平台 | 架构 | 文件 |\n|------|------|------|\n| Linux | x86_64 | `cc-switch-linux-x86_64` / `cc-switch-linux-x86_64-musl` |\n| Linux | ARM64 | `cc-switch-linux-aarch64` / `cc-switch-linux-aarch64-musl` |\n| Linux | ARMv7 | `cc-switch-linux-armv7` |\n| macOS | Intel | `cc-switch-darwin-x86_64` |\n| macOS | Apple Silicon | `cc-switch-darwin-aarch64` |\n| Windows | x86_64 | `cc-switch-windows-x86_64.exe` |\n\n### 🔧 从源码编译\n\n```bash\n# 克隆仓库\ngit clone https://github.com/DoBestone/cc-switch-cli.git\ncd cc-switch-cli\n\n# 编译 release 版本\ncargo build --release\n\n# 安装到系统路径\nsudo cp target/release/cc-switch /usr/local/bin/\n```\n\n**编译要求**: Rust 1.70.0+\n\n## 📖 使用方法\n\n### 🎨 交互式界面（推荐）\n\n```bash\n# 简单菜单模式（默认）\ncc-switch\n\n# 高级 TUI 模式\ncc-switch --tui\n```\n\n**启动时自动检查版本更新**，有新版本时会显示提示。\n\n### 基本命令\n\n```bash\n# 显示帮助\ncc-switch --help\n\n# 列出所有供应商\ncc-switch list\n\n# 显示当前状态\ncc-switch status\n\n# 切换供应商\ncc-switch use my-provider --app claude\n\n# 添加供应商\ncc-switch add my-provider --app claude --api-key \"sk-xxx\" --base-url \"https://api.example.com\"\n\n# 测试供应商\ncc-switch test my-provider --app claude\n\n# 删除供应商\ncc-switch remove my-provider --app claude\n```\n\n### 批量操作\n\n```bash\n# 批量切换所有应用\ncc-switch batch switch \"云雾API\"\n\n# 批量测试所有供应商\ncc-switch batch test\n\n# 批量导出配置\ncc-switch batch export backup.yaml\n\n# 批量导入配置\ncc-switch batch import backup.yaml\n\n# 批量同步（从一个应用到其他应用）\ncc-switch batch sync --from claude --to codex gemini\n\n# 批量编辑\ncc-switch batch edit base-url \"https://api.example.com\" --app all\n```\n\n### 故障转移\n\n```bash\n# 查看故障转移队列\ncc-switch failover list --app claude\n\n# 添加备用供应商\ncc-switch failover add backup-api --app claude\n\n# 移除备用供应商\ncc-switch failover remove backup-api --app claude\n```\n\n### 使用量统计\n\n```bash\n# 查看使用量汇总\ncc-switch usage summary\n\n# 查看趋势\ncc-switch usage trends --days 7\n\n# 设置限额\ncc-switch usage set-limit my-api --daily 10 --monthly 100\n```\n\n### WebDAV 云同步\n\n```bash\n# 配置 WebDAV\ncc-switch webdav setup --url https://dav.example.com --username user --password pass\n\n# 测试连接\ncc-switch webdav test\n\n# 上传配置\ncc-switch webdav upload\n\n# 下载配置\ncc-switch webdav download\n```\n\n### Web 控制器\n\n```bash\n# 启动 Web 控制器（默认端口 8000）\ncc-switch web\n\n# 自定义端口和登录信息\ncc-switch web --port 3000 --user admin --pass secret123\n\n# 仅本地访问\ncc-switch web --host 127.0.0.1\n```\n\n### OpenClaw 配置\n\n```bash\n# 列出 OpenClaw 供应商\ncc-switch openclaw list\n\n# 添加供应商\ncc-switch openclaw add my-api --base-url https://api.example.com --api-key sk-xxx\n\n# 设置默认模型\ncc-switch openclaw default-model --primary gpt-4\n\n# 健康检查\ncc-switch openclaw health --fix\n```\n\n## 📁 配置文件位置\n\n| 路径 | 说明 |\n|------|------|\n| `~/.cc-switch/` | CC-Switch 配置目录 |\n| `~/.cc-switch/cc-switch.db` | SQLite 数据库 |\n| `~/.cc-switch/settings.json` | 本地设置 |\n| `~/.claude/` | Claude Code 配置 |\n| `~/.codex/` | Codex CLI 配置 |\n| `~/.gemini/` | Gemini CLI 配置 |\n| `~/.opencode/` | OpenCode 配置 |\n| `~/.openclaw/` | OpenClaw 配置 |\n\n## 🔄 版本更新策略\n\nCC-Switch 采用智能版本更新策略：\n\n| 版本类型 | 示例 | 行为 |\n|---------|------|------|\n| 🔴 大版本 | `1.x.x` → `2.x.x` | 强制提示，需用户确认（可能有不兼容变更） |\n| 🟡 中版本 | `1.1.x` → `1.2.x` | 推荐更新，默认提示 |\n| 🟢 小版本 | `1.1.1` → `1.1.2` | 选择性更新，静默提示 |\n\n## 📊 功能对比\n\n| 功能 | 命令行 | 交互式菜单 | 批量操作 |\n|------|--------|------------|----------|\n| 供应商管理 | ✅ | ✅ | ✅ |\n| MCP 服务器 | ✅ | ✅ | ❌ |\n| Prompts | ✅ | ✅ | ❌ |\n| Skills | ✅ | ✅ | ❌ |\n| 代理设置 | ✅ | ✅ | ❌ |\n| 端点测速 | ✅ | ✅ | ❌ |\n| 环境检测 | ✅ | ✅ | ❌ |\n| 故障转移 | ✅ | ❌ | ✅ |\n| 使用量统计 | ✅ | ❌ | ❌ |\n| WebDAV 同步 | ✅ | ❌ | ❌ |\n| Web 控制器 | ✅ | ❌ | ❌ |\n| 批量切换/测试/导出/导入/同步/编辑 | ✅ | ❌ | ✅ |\n\n## 🛠️ 项目结构\n\n```\ncc-switch-cli/\n├── Cargo.toml              # 工作区配置\n├── ccswitch-core/          # 核心库 (lib crate)\n│   └── src/\n│       ├── lib.rs          # 公共 API\n│       ├── config.rs       # 配置文件处理\n│       ├── database/       # SQLite 数据持久化\n│       ├── provider.rs     # 供应商数据结构\n│       └── services/       # 业务逻辑层\n└── ccswitch-cli/           # CLI 工具 (bin crate)\n    └── src/\n        ├── main.rs         # 入口\n        ├── cli.rs          # clap 参数定义\n        ├── commands/       # 命令实现\n        ├── interactive.rs  # 交互式菜单\n        └── tui.rs          # 高级 TUI\n```\n\n## 📝 更新日志\n\n### v1.2.3 (2026-03-12)\n- ✨ 增强版本检查系统，支持大/中/小版本更新策略\n- ✨ 添加启动时自动版本检查\n- ✨ 增强 GitHub API 限流处理\n- ✨ 为 install.sh 添加 SHA256 校验支持\n- 🐛 修复版本解析问题，支持预发布版本\n\n### v1.2.0 - v1.2.2\n- ✨ 添加 Web 控制器（带身份验证）\n- ✨ 添加 WebDAV 云同步\n- ✨ 添加使用量统计\n- ✨ 添加故障转移功能\n- ✨ 添加 OpenClaw 支持\n- 🐛 多项 Bug 修复\n\n[查看完整更新日志](https://github.com/DoBestone/cc-switch-cli/releases)\n\n## 📜 许可证\n\nMIT License - 与原项目保持一致\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n---\n\n**Star ⭐ 本项目以获取最新更新！**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdobestone%2Fcc-switch-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdobestone%2Fcc-switch-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdobestone%2Fcc-switch-cli/lists"}