快速开始
CC Models 是一款跨平台桌面应用，帮助你一站式管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的 API 提供商和配置。
第一步：下载安装
根据你的操作系统选择对应的安装包：
- Windows：下载
.msi安装包或便携版.zip - macOS：推荐使用 Homebrew 安装
brew install --cask cc-models - Linux：下载
.deb、.rpm或.AppImage格式
第二步：添加提供商
打开 CC Models 后，点击"添加提供商"按钮，从 50+ 内置预设中选择，或创建自定义配置，粘贴你的 API Key 即可。
第三步：一键切换
在主界面选择目标提供商，点击"启用"。你也可以通过系统托盘菜单快速切换提供商。
第四步：开始使用
重启相应的 CLI 工具使配置生效。Claude Code 支持热切换，无需重启即可应用新配置。
安装指南
系统要求
- Windows：Windows 10 及以上
- macOS：macOS 12 (Monterey) 及以上
- Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+
Windows 安装
下载 MSI 安装包，双击运行安装向导即可。也提供便携版（无需安装），解压后直接运行。
macOS 安装
下载 DMG 文件手动安装。macOS 版本已通过 Apple 代码签名和公证。
Linux 安装
chmod +x CC-Models-v{version}-Linux.AppImage
./CC-Models-v{version}-Linux.AppImage提供商管理
CC Models 内置了 50+ 提供商预设，涵盖第三方 API 代理和社区中继。你可以：
- 导入预设：一键导入 AWS Bedrock、NVIDIA NIM 等官方预设
- 自定义配置：创建自定义提供商，配置 API 地址、认证方式和模型映射
- 拖拽排序：通过拖拽调整提供商列表顺序
- 导入导出：支持提供商配置的导入和导出
- 通用提供商：设置一次，同步到多个应用
代理网关
CC Models 内置本地代理网关，支持：
- 格式转换：Anthropic ↔ OpenAI 格式自动转换
- 自动故障转移：提供商不可用时自动切换到备用提供商
- 熔断器：防止级联故障
- 健康监控：实时监控提供商可用性
- 请求修正：自动修正兼容性问题
- 应用级接管：独立代理 Claude、Codex 或 Gemini
MCP 管理
统一的 MCP（Model Context Protocol）管理面板：
- 统一管理多个应用的 MCP 服务器
- 支持双向同步
- Deep Link 导入（
ccmodels://） - 模板化添加服务器
- 按应用切换同步开关
Skills 管理
一键安装和管理 Skills：
- 从 GitHub 仓库或 ZIP 文件一键安装 Skills
- 自定义仓库管理和 Symlink 支持
- 跨应用 Skills 同步
- 自动备份（保留最近 20 份）
会话管理
全面管理你的 AI 编程会话：
- 浏览所有应用的对话历史
- 全文搜索和过滤
- 一键恢复历史会话
- 查看详细对话内容和 Token 消耗
- Workspace 编辑器（支持 Markdown 预览）
仪表盘
直观的用量和成本追踪仪表盘：
- 消费金额、请求次数、Token 使用量统计
- 趋势图表展示
- 缓存归一化的真实总 Token 数和缓存命中率
- 可自定义的模型定价
- 日期范围、提供商、模型筛选器
- 详细的请求日志
云同步
通过以下方式跨设备同步配置数据：
- Dropbox
- OneDrive
- iCloud
- WebDAV
- NAS（网络存储）
- 自定义配置目录
设置与配置
全局设置管理：
- 主题：深色 / 浅色 / 跟随系统
- 语言：中文 / English / 日本語
- 自动启动：开机自启
- 自动更新：自动检测和安装新版本
- 数据存储：所有数据存储在
~/.cc-models/目录，包括 SQLite 数据库、设置文件和自动备份（保留最近 10 份） - 原子写入：配置文件原子化写入，防止损坏
常见问题
支持哪些 CLI 工具？
CC Models 目前支持 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw。
切换提供商后需要重启吗？
大多数工具需要重启终端。Claude Code 支持热切换，无需重启。
如何恢复官方登录？
添加"官方登录"预设提供商，切换后重启 CLI 工具，按官方流程登录即可。
数据会被发送到云端吗？
不会。所有数据默认存储在本地。只有在你主动配置云同步后，数据才会同步到你指定的云存储。
CC Models 是免费的吗？
是的，CC Models 完全免费且开源。请只从官方渠道下载。