ccs

一个命令行搞定所有 AI 账号和模型切换

ccs 是一个面向 AI 开发者的命令行工具，用于在 Claude、Gemini、Copilot、OpenRouter 等多家 AI 服务商的 300 多个模型之间快速切换。它通过 CLI、代理 API 和 OAuth 代理三种方式统一管理多个账号，解决了开发者频繁切换不同 AI 服务商账号和模型的痛点。项目提供可视化仪表盘，支持远程代理部署，并内置 WebSearch 回退机制，确保搜索功能在模型不支持时依然可用。核心能力包括零配置启动、多账号统一管理、模型路由、代理转发和搜索降级，从个人开发到生产环境均可直接使用。

开源 free 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2859

维护状态活跃

是否开源是

定价模式 free

项目数据

分类基础设施

开发团队kaitranntt

所属国家

官网地址https://ccs.kaitran.ca

GitHubhttps://github.com/kaitranntt/ccs

定价模式free

价格说明开源项目，MIT 许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-gateway,anthropic-api,claude,claude-code,cli-tool,cliproxyapi,developer-productivity,gemini,github-copilot,multi-account,nodejs,oauth,openrouter,profile-switching,react-dashboard,typescript,websearch

GitHub 星标★ 2859

30天Star增速

HF 下载量

上线时间2025-11-01 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：Docker 7 步

环境要求

已安装 Docker 与 Docker Compose（Docker 方式）
Node.js 与 npm 环境（主机安装方式）
能访问 ccs.kaitran.ca 或 raw.githubusercontent.com 的网络
本机 3000 与 8317 端口未被占用

安装与启动步骤

1下载 compose 文件

从官网拉取官方 docker-compose.yaml 到当前目录，文件位置决定后续启动目录。
```
curl -fsSL https://ccs.kaitran.ca/docker-compose.yaml -o docker-compose.yaml
```
2后台启动服务

在 compose 文件所在目录执行，拉取镜像并以后台方式启动仪表盘与 CLIProxy。
```
docker compose up -d
```
3打开仪表盘

浏览器访问 http://localhost:3000 查看仪表盘，CLIProxy 服务监听 http://localhost:8317。
4全局安装 CLI

不使用 Docker 时，用 npm 全局安装 ccs 命令行工具；Docker 用户可跳过本步。
```
npm install -g @kaitranntt/ccs
```
5初始化配置

运行交互式配置，设置要使用的服务商档案与账号信息。
```
ccs config
```
6启动运行时

按需选择运行时：ccs 启动默认，codex、xai（别名 ccs grok）、glm、ollama 等各对应一个模型来源。
```
ccs
ccs codex
ccs xai
ccs --target droid glm
ccs glm
ccs ollama
```
7运行本地模型

需要隐私或离线场景时，用 ccs ollama 直接传入提示词调用本地模型。
```
ccs ollama "summarize these logs"
```

如何确认成功

浏览器打开 http://localhost:3000 能进入仪表盘、http://localhost:8317 的 CLIProxy 有响应即启动成功；CLI 方式执行 ccs 能进入运行时。

常见问题

Q：Docker 该用哪个镜像？

A：ghcr.io/kaitranntt/ccs-dashboard:latest 已废弃，请改用 ghcr.io/kaitranntt/ccs:latest，迁移细节见 issue #1251 与 docker/README.md。

Q：公司代理环境下下载不了 compose 文件怎么办？

A：改用直链下载：https://raw.githubusercontent.com/kaitranntt/ccs/main/docker/compose.yaml 保存为 compose.yaml 后再启动。

Q：不想用 Docker，能直接装在宿主机吗？

A：可以。执行 npm install -g @kaitranntt/ccs 全局安装，然后运行 ccs config 完成配置，再用 ccs 系列命令启动运行时。

Q：怎么切换不同服务商或模型？

A：通过 ccs 的不同子命令切换运行时，例如 ccs codex、ccs xai（别名 ccs grok）、ccs glm、ccs --target droid glm，无需反复改配置文件。

Q：如何查看用量和成本？

A：仪表盘提供 Usage Analytics，可跨档案跟踪用量、成本与会话模式，详见文档 Dashboard Analytics 页面。

注意事项

ccs-dashboard 镜像已弃用，统一使用 ghcr.io/kaitranntt/ccs:latest。
Docker 方式默认暴露 3000（仪表盘）和 8317（CLIProxy）两个端口，注意端口冲突。
要把同网络的兄弟容器接入 CLIProxy，参考 docker/README.md 的 Connect your app to CLIProxy 一节。
更多 CLI 命令与参数见官方文档 CLI Reference：https://docs.ccs.kaitran.ca/reference/cli-commands。

核心亮点

支持 300+ 模型，覆盖主流 AI 服务商，切换零成本
提供可视化仪表盘和远程代理，适合团队协作
WebSearch 回退机制，兼容不支持搜索的模型

不足之处

文档/社区待观察
依赖第三方 API 稳定性，多服务商集成维护成本高

适用场景

开发者本地调试多个 AI 模型，快速对比输出效果
团队共享代理，统一管理多账号和 API 密钥
需要 WebSearch 但模型不原生支持时的降级方案

替代项目

claude-code-router、aichat、one-api

项目介绍

ccs 是基础设施领域的开源项目，由 kaitranntt 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,859）位列前 30%，在基础设施分类中处于中上游。

近 42 天，它的 GitHub 星标从 2,798 增加到 2,859，净增 61。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT 许可证，可自行部署，完全免费。

它主要面向的使用场景是：开发者本地调试多个AI模型，快速对比输出效果。同类可对比的替代方案包括 claude-code-router、aichat、one-api。

上一篇：octelium

下一篇：krakend-ce

ccs