Claude Code 一站配置

Claude Code · CC Switch

CC Switch 可以理解成“Claude Code 配置管理器”——它不是模型也不是聊天软件,只是帮你把本站 API 地址和密钥写到正确的位置,并方便以后切换。这一页带你下载安装 → 配置本站 → 确认生效

先说明:本站是 GPT 模型

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
Windows 不会选就点上面那个

下载完成后双击 .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 配置。不想看文字可以直接看图:

CC Switch 配置图片教程
按 1 到 5 的顺序操作。
配置名称
Issue A Card
工具
Claude Code / Anthropic
Base URL
https://issueacard.top
API Token
你的 sk- 开头 API 密钥
认证方式
界面让你选时,优先 Bearer Token 或 Anthropic API Key。
Base URL 不要加 /v1

Claude Code 会自己请求 /v1/messages。如果写成 https://issueacard.top/v1,最后会变成重复路径。

要配 Codex 的话不要套用本页

Codex 走 OpenAI / Responses 兼容,Base URL 规则不同(通常要加 /v1)。请看 在 Codex 使用

桌面版操作

打开 CC Switch,新增配置

进入配置或 Provider 管理页面,找包含 Provider、Claude Code、配置、Profile 字样的位置,选择新增。

选择 Claude Code

工具类型选 Claude Code;有供应商类型时选 AnthropicCustom 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 只是配置管理器,不替代它)。