CC Switch (CCS) 一键管理与配置导入

CC Switch 是专为现代 AI 开发者打造的跨平台环境与服务商管理神器。它支持一键管理并无缝切换 Claude Code、Codex、OpenCode、Gemini CLI 等多个主流 AI 辅助编程工具的环境变量与配置文件，无需手动反复修改系统配置。

---

1. 安装 CC Switch

访问 CC Switch 官方下载页 或 GitHub Releases 下载对应系统的安装包：

操作系统	推荐安装包类型
Windows	.msi 或 .exe 安装程序
macOS	.dmg 镜像（支持 Intel 与 Apple Silicon M系列芯片）
Linux	.AppImage / .deb / .rpm

---

2. 从智坞控制台一键导入

1. 登录 智坞 AI 控制台，进入 「令牌 (Tokens)」 页面；
2. 找到您要用于编程工具的 API Key，点击操作栏中的 「导入到 CCS」（或复制导入链接）；
3. 浏览器唤起 CC Switch 客户端后点击允许；
4. CC Switch 将自动为您填充供应商名称、主地址与 Key；
5. 将当前启用的供应商切换为您导入的 智坞 AI (KeyDock) 即可！

---

3. 手动在 CC Switch 中添加供应商

如果您想手动在 CC Switch 中配置：

1. 打开 CC Switch 客户端，点击左侧菜单的 「供应商管理 (Providers)」；
2. 点击 「+ 添加供应商」；
3. 选择目标工具分类（例如 Claude Code 或 Codex）：
   • 供应商名称：智坞 AI (KeyDock)
   • API 接口地址：https://aikeydock.online（针对 Claude Code 填写裸域名，针对 Codex/OpenCode 填写 https://aikeydock.online/v1）
   • API Key：填入您的智坞 sk-xxx 令牌
   • 模型：输入或勾选 gpt-5.6-sol、gpt-5.6-terra、deepseek-v4-pro、deepseek-v4-flash、claude-opus-5、claude-opus-4-8 等；
4. 点击 保存，并在首页将该配置设为 活动 (Active) 状态。

---

4. 关键避坑与注意事项

避免本地路由冲突

CC Switch 内置了可选的“本地路由代理”功能。在直连智坞 AI 官方聚合网关时：

• 请进入 CC Switch ➔ 设置 ➔ 路由；
• 确认 本地路由总开关保持为「关闭」状态；
• 这样可以避免本地二次代理改写请求端口或产生死循环。

---

5. 重启客户端完成验证

配置或切换供应商后：

1. 完全退出 目标客户端（如关闭 Claude Code 终端进程或重启 VSCode）；
2. 重新启动终端并运行简单测试（例如 claude -p "你好" 或 codex "ping"）；
3. 控制台将立即显示成功的调用日志与 Token 消耗。