ccs

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署基础设施 🍴 复刻 278 🐛 待处理 14 👀 关注 14

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2896

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，可自行部署，完全免费。

项目预览

项目数据

分类基础设施

开发团队kaitranntt

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

GitHubhttps://github.com/kaitranntt/ccs

定价模式🏷️完全免费

价格说明开源项目，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 星标★ 2896

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

代码更新2026-11-04

仓库体积44.6 MB

本站数据更新2026-11-07

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2896

技术标签

ai-gateway anthropic-api claude claude-code cli-tool

使用教程

难度：入门约 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。