为什么选择 CCS

CCS 提供一个稳定的命令行界面，同时允许您在以下之间快速切换：

• 多种运行时环境，如 Claude Code、Factory Droid 和 Codex CLI
• 多个 Claude 订阅及隔离的账户上下文
• OAuth 提供商，例如 Codex、Copilot、Kiro、Claude、Qwen、Kimi 等
• API 和本地模型配置，如 GLM、Kimi、OpenRouter、Ollama、llama.cpp、Novita 和 Alibaba Coding Plan

目标很简单：不再需要频繁重写配置文件，不再破坏当前会话，几秒钟内即可在不同提供商之间切换。

快速开始

npm install -g @kaitranntt/ccs
ccs config

然后根据任务需求启动相应的运行时：

ccs
ccs codex
ccs --target droid glm
ccs glm
ccs ollama

如果您需要完整的设置流程而不是简短版本？

需求	从这里开始
安装并验证 CCS	/getting-started/installation
第一次成功会话	/getting-started/first-session
视觉化教程	/getting-started/product-tour
选择提供商	/providers/concepts/overview
完整命令参考	/reference/cli-commands
故障排除	/reference/troubleshooting

观看 CCS 实际应用

使用情况分析

跨配置跟踪使用情况、成本和会话模式。深入了解： 仪表盘分析。

实时认证与健康监测

无需进入原始配置即可查看认证状态、账户健康状况和提供商就绪情况。深入了解： 实时认证监控。

OAuth 提供商控制中心

在一个地方管理基于 OAuth 的提供商、配额可见性以及代理级路由。CCS 现在在 CLI 和仪表盘流程中原生支持轮询与优先填充两种模式，而不再将其隐藏在上游控制中。深入了解： CLIProxy API。

管理工具与后备方案

对于第三方调用，CCS 可以提供一流的本地工具，如 WebSearch 和图像分析，而无需您手动配置。深入了解： WebSearch。

文档矩阵

README 有意保持简洁，详细指南和参考资料则由文档网站负责。

如果您想...	请阅读此内容
了解 CCS 是什么以及各部分如何协同工作	简介
在新机器上干净地安装 CCS	安装
从安装到首次成功运行	您的第一次 CCS 会话
在设置前查看仪表盘和工作流界面	产品导览
比较 OAuth 提供商、Claude 账户和 API 配置	提供商概览
学习仪表盘结构和功能页面	仪表盘概览
配置 profiles、路径和环境变量	配置
使 OpenCode 与您的 CCS 设置保持同步	OpenCode 同步插件
浏览所有命令和标志	CLI 命令参考
从安装、认证或提供商故障中恢复	故障排除
理解存储、配置和架构细节	参考

示例工作流程

# 使用默认 Claude 进行设计
ccs "设计认证流程"

# 使用不同的提供商进行实现
ccs codex "实现用户服务"

# 对于常规工作，使用更便宜的 API 配置
ccs glm "清理测试和文档"

# 当需要隐私或离线访问时，运行本地模型
ccs ollama "总结这些日志"

社区项目

项目	作者	描述
opencode-ccs-sync	@JasonLandbridge	自动将 CCS 提供商同步到 OpenCode

贡献与安全报告

• 贡献指南：CONTRIBUTING.md
• 初学者任务： good first issue, help wanted
• 问题：提交问题
• 安全报告：SECURITY.md 和 私人咨询表单

星标历史

CCS (Claude Code Switch) 快速上手指南

CCS 是一个多提供商配置文件和运行时管理器，专为 Claude Code 及兼容的 CLI 工具设计。它允许你在不反复修改配置文件的情况下，无缝切换不同的运行时（如 Claude Code, Codex, Droid）、多个订阅账户、OAuth 提供商（如 Copilot, Kimi, Qwen）以及本地模型（如 Ollama, llama.cpp）。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: macOS, Linux 或 Windows (WSL2 推荐)。
• Node.js: 需安装 Node.js (建议 LTS 版本)，因为 CCS 通过 npm 分发。
  • 检查版本：node -v (建议 v18+)
  • 检查 npm：npm -v
• 目标运行时: 根据你想使用的模型，可能需要预先安装相应的 CLI 工具（如 claude-code, ollama 等），但 CCS 旨在简化这些工具的配置管理。

国内开发者提示：如果访问 npm 官方源较慢，建议使用国内镜像源进行安装。

# 临时使用淘宝镜像源安装
npm install -g @kaitranntt/ccs --registry=https://registry.npmmirror.com

安装步骤

1. 全局安装 CCS

使用 npm 全局安装 CCS 包：

npm install -g @kaitranntt/ccs

(若使用国内镜像，请参考上方环境准备中的命令)

2. 初始化配置

安装完成后，运行配置命令以设置初始环境和验证安装：

ccs config

按照终端提示完成基础配置（如选择默认提供商、设置 API Key 或 OAuth 登录等）。

基本使用

配置完成后，你可以直接使用 ccs 命令调用不同的模型或运行时，无需手动切换配置文件。

启动默认会话

使用默认配置的模型（通常为 Claude）开始对话：

ccs

指定特定运行时

直接调用特定的 CLI 工具或模型配置文件：

# 使用 Codex
ccs codex

# 使用 GLM 模型（通过 droid 路由或直接调用）
ccs --target droid glm
# 或者简写
ccs glm

# 使用本地 Ollama 模型
ccs ollama

结合指令使用

你可以直接在命令后跟随自然语言指令，CCS 会自动将其传递给选定的模型：

# 使用默认 Claude 设计认证流程
ccs "design the auth flow"

# 使用 Codex 实现用户服务
ccs codex "implement the user service"

# 使用 GLM 清理测试和文档（适合常规任务以节省成本）
ccs glm "clean up tests and docs"

# 使用本地 Ollama 总结日志（适合隐私敏感或离线场景）
ccs ollama "summarize these logs"

通过以上命令，你可以在几秒钟内于不同的 AI 提供商和本地模型之间自由切换，专注于开发任务本身。