Claude Code · CC Switch
CC Switch 可以理解成“Claude Code 配置管理器”——它不是模型也不是聊天软件,只是帮你把本站 API 地址和密钥写到正确的位置,并方便以后切换。这一页带你下载安装 → 配置本站 → 确认生效。
Claude Code 按 Claude 设计,接 GPT 后端要经协议翻译,可能遇到个别兼容问题(工具调用、思考块等)。追求稳定建议优先用 Codex;坚持用 Claude Code 的话,按本页配置即可。
本来可以手动改 Claude Code 的配置文件,但小白容易填错位置。CC Switch 把 Base URL、密钥、当前启用配置集中在一处,填写更稳、切换更快、出问题也更好排查。
第一步 · 下载安装
Windows 用户可以直接下载本站缓存好的最新安装包(来自 CC Switch 官方 GitHub Release)。
- 当前版本
v3.14.1- 文件名
CC-Switch-v3.14.1-Windows.msi- 大小
- 约 12 MB
- SHA256
82131ae0fb57dbea5ab8d1b67c67408e0fdf6b5b5c9136e7061aebaba7a4bc1b
下载完成后双击 .msi,一路按安装向导操作即可。
其它系统怎么装
- 官网
- https://ccswitch.ai/
- 官方 Release
- GitHub Release v3.14.1
- macOS
- 下载安装包,或用 Homebrew(见下)。
- Linux
- 按发行版选择
.deb、.rpm或.AppImage。
macOS Homebrew:
brew tap farion1231/ccswitch
brew install --cask cc-switch
习惯终端的用户也可以装命令行版(二选一即可,新手装桌面版更直观):
npm install -g @hobeeliu/cc-switch
cc-switch init
第二步 · 配置本站
这一步把“本站 API 地址 + 你的 sk- 密钥”保存成一个 Claude Code 配置。不想看文字可以直接看图:
- 配置名称
Issue A Card- 工具
- Claude Code / Anthropic
- Base URL
https://issueacard.top- API Token
- 你的
sk-开头 API 密钥 - 认证方式
- 界面让你选时,优先 Bearer Token 或 Anthropic API Key。
Claude Code 会自己请求 /v1/messages。如果写成 https://issueacard.top/v1,最后会变成重复路径。
Codex 走 OpenAI / Responses 兼容,Base URL 规则不同(通常要加 /v1)。请看 在 Codex 使用。
桌面版操作
打开 CC Switch,新增配置
进入配置或 Provider 管理页面,找包含 Provider、Claude Code、配置、Profile 字样的位置,选择新增。
选择 Claude Code
工具类型选 Claude Code;有供应商类型时选 Anthropic 或 Custom Anthropic Endpoint。
填入本站参数
Base URL 填 https://issueacard.top,Token 填你的 sk- 密钥。
保存并切换
保存后点击切换或启用,切换成功再打开 Claude Code。
命令行版操作
命令行版通常把配置保存到 ~/.claude/profiles/。新建并启用一个配置:
cc-switch new issue-a-card -i
cc-switch use issue-a-card
它最终写入的核心就是下面两个环境变量:
ANTHROPIC_BASE_URL=https://issueacard.top
ANTHROPIC_AUTH_TOKEN=sk-你的密钥
有些配置用 ANTHROPIC_API_KEY。本站同时支持 Bearer Token 和 x-api-key,通常都能工作。
配置完怎么确认
- CC Switch 当前配置显示为
Issue A Card。 - Base URL 是
https://issueacard.top,没有多余的/v1。 - API 密钥完整复制,没有少字符、空格或换行。
- 有“测试连接”按钮就先点一次测试。
- 电脑上已经装好 Claude Code(CC Switch 只是配置管理器,不替代它)。