Claude Code 配置生成器：一键生成 Codex CLI、Cline、Cursor、Cherry Studio 接入配置
选好工具、系统和 model，下面直接生成可以一键复制的配置。两条规则记住就不会配错：Claude Code 这类走 Anthropic 协议的工具，ANTHROPIC_BASE_URL=https://www.ccsub.net（末尾不加 /v1），Key 放在 ANTHROPIC_AUTH_TOKEN； Codex CLI、Cline、Cursor 等走 OpenAI 兼容协议的工具，地址填https://www.ccsub.net/api/v1。
把下面的 sk-你的Key 换成你在 CCSub「API 密钥」页创建的 Key。
还没有 Key？去注册生成结果 · Claude Code · macOS / Linux（zsh）
方式一：写入环境变量（~/.zshrc）
echo 'export ANTHROPIC_BASE_URL="https://www.ccsub.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的Key"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc
source ~/.zshrc- 这几行执行一次就够了，重复执行会在文件里追加重复的行。之后新开的终端都会自动带上这些变量。
方式二：写进 ~/.claude/settings.json（对所有项目生效）
{
"env": {
"ANTHROPIC_BASE_URL": "https://www.ccsub.net",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
},
"model": "claude-sonnet-5"
}- 文件已经存在时，把 env 里的两项和 model 合并进原有内容，不要整份覆盖。settings.json 是严格 JSON：不能写注释，最后一项后面不能有逗号。
- settings.json 里 env 的值会覆盖终端里 export 的同名变量。改了终端变量却不生效时，先检查这个文件。
启动并验证
- 进入后随便发一句话，能收到回复就说明接通了。
- 到 CCSub 控制台的「使用记录」页，能看到这次请求的 model、Token 数和扣费。
cd ~/你的项目目录
claude两个地址：先分清工具走哪种协议
CCSub 同时提供 Anthropic 兼容接口和 OpenAI 兼容接口，用的是同一个 Key。配错地址是接入失败最常见的原因，而规律只有一条：客户端会自己在地址后面拼接口路径，你只需要填它要求的「前半段」。
| 协议 | 填写的地址 | 典型工具 | 客户端自己拼上的路径 |
|---|---|---|---|
| Anthropic Messages | https://www.ccsub.net | Claude Code、cc-switch（Claude Code）、Cline 的 Anthropic 方式 | /v1/messages |
| OpenAI 兼容 | https://www.ccsub.net/api/v1 | Codex CLI、Cline、Cursor、cc-switch（Codex） | /responses、/chat/completions、/models |
| OpenAI 兼容（Cherry Studio） | https://www.ccsub.net | Cherry Studio 的 OpenAI 端点 | /v1/chat/completions |
https://www.ccsub.net/v1 和 https://www.ccsub.net/api/v1 指向同一个 OpenAI 兼容接口；文档统一写 /api/v1。 只写域名时，对话接口能用，但 /models 会落到网站的模型介绍页上，拉模型列表的工具会拿到一整页 HTML。
每个字段是什么意思
| 字段 | 用在哪 | 含义与注意事项 |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code | 请求发往的地址，填域名即可。按 Claude Code 官方文档，指向非官方地址时 MCP 工具会在启动时一次性全部加载，MCP 很多的话每次请求的输入 Token 会明显变多。 |
ANTHROPIC_AUTH_TOKEN | Claude Code | 你的 CCSub Key，以 Authorization: Bearer 的形式发送。 |
ANTHROPIC_API_KEY | Claude Code | 另一种写法，以 X-Api-Key 发送，CCSub 两种都认。但设置它后，交互模式下 Claude Code 会先让你确认一次是否使用这个 Key，所以文档统一用 AUTH_TOKEN。 |
ANTHROPIC_MODEL / model | Claude Code | 默认 model ID。优先级：启动参数 --model 与会话里的 /model 最高，其次 ANTHROPIC_MODEL，最后是 settings.json 里的 model。 |
env | ~/.claude/settings.json | 每次启动都注入的环境变量，会覆盖终端里 export 的同名变量。 |
model / model_provider | Codex config.toml | 默认 model ID，以及使用哪个服务商（指向下面的 [model_providers.ccsub] 段）。 |
base_url | Codex config.toml | 服务商地址，填 https://www.ccsub.net/api/v1，Codex 会自己拼 /responses。 |
env_key | Codex config.toml | 存放 Key 的环境变量名（不是 Key 本身）。 |
wire_api | Codex config.toml | 协议。Codex 官方配置文档写明目前只支持 responses，也是默认值。 |
| Base URL / Model ID | Cline | API Provider 选 OpenAI Compatible 后出现的两个输入框；Model ID 可以手动输入任意型号 ID。 |
| Override OpenAI Base URL | Cursor | Cursor Settings → Models → API Keys 里的开关，打开后对所有非 Claude / Gemini 模型生效。 |
| API 地址 | Cherry Studio | 填根地址，Cherry Studio 会自动补 /v1/chat/completions；以 # 结尾时按原样请求。 |
常见错误
ANTHROPIC_BASE_URL 末尾加了 /v1
Claude Code 自己会拼 /v1/messages，地址里再带 /v1 就成了 /v1/v1/messages，结果是 404 或一直连不上。 正确写法是 https://www.ccsub.net，末尾也不要多一个斜杠。
OpenAI 兼容地址只写了域名，或少了 /api
Codex 报 unexpected status 404 Not Found: <!DOCTYPE html>、Cline 或其他工具提示「模型列表为空」「无法解析响应」， 通常是请求落到了网站页面上。把地址改成 https://www.ccsub.net/api/v1。
改了环境变量，工具还是连着旧地址
已经打开的终端不会自动刷新变量：macOS / Linux 执行 source ~/.zshrc 或新开终端；Windows 用 SetEnvironmentVariable 写入后，要关掉所有终端窗口重开， VS Code 里的终端需要整个 VS Code 重启。还不生效就检查 ~/.claude/settings.json，那里的 env 会覆盖终端变量。
config.toml 改了不生效
两个常见原因：写在了项目目录的 .codex/config.toml（Codex 不在项目级配置里读取 model_provider / model_providers）； 或者把 model = ... 写在了文件末尾某个 [表头] 下面，被当成了那个表的字段。顶层的键要放在所有表头之前。
401 Unauthorized / invalid_api_key
Key 复制时多了空格、引号或换行，或者把占位符原样留在了配置里。也可能是工具还在用官方地址，拿 CCSub 的 Key 去请求官方接口自然会被拒绝。
Cursor 里 claude- 开头的自定义模型报错
Cursor 按模型名开头决定发哪个 Key，claude- 开头会改用 Anthropic Key 槽位，不走 Override OpenAI Base URL。在 Cursor 里用 GPT 系 model ID 即可。
终端报 Connection error、ECONNREFUSED、ETIMEDOUT
这类报错和配置写法无关，多半是网络或终端代理的问题。先用连通性检测确认浏览器能不能到达接口，再按页面里的 curl 命令在终端里测一次。
常见问题
这个配置生成器需要登录吗？会收集我的 Key 吗？
不需要登录。页面只在你的浏览器里拼出配置文本，Key 一律用占位符 sk-你的Key 表示，复制后在本地换成自己的 Key 即可；页面没有任何输入 Key 的地方，也不会上传数据。
Claude Code 的 ANTHROPIC_BASE_URL 为什么不能带 /v1？
Claude Code 会自己在地址后面拼接 /v1/messages。填 https://www.ccsub.net 时实际请求的是 https://www.ccsub.net/v1/messages；如果填成 https://www.ccsub.net/v1，就会变成 /v1/v1/messages，返回 404。
OpenAI 兼容地址到底写 /api/v1 还是 /v1？
CCSub 文档统一写 https://www.ccsub.net/api/v1。https://www.ccsub.net/v1 指向同一个接口，cc-switch 内置的 CCSub 预设用的就是它，两种都能用。但不要只写域名：部分工具会去请求 https://www.ccsub.net/models 拉模型列表，这个地址是网站的模型介绍页，返回的是网页而不是接口数据。
环境变量和 ~/.claude/settings.json 选哪个？
二选一即可。环境变量对从终端启动的程序都生效；settings.json 只给 Claude Code 用，不依赖终端，从编辑器插件等图形界面启动时也能读到。两边都写了同名变量时，以 settings.json 的 env 为准。
model 下拉框里为什么只有一部分型号？
下拉框按工具的协议筛选：Claude Code 只列 Claude 系 model ID，Codex CLI 只列 GPT 系；Cursor 也只列 GPT 系，因为 Cursor 会把 claude- 开头的模型名交给 Anthropic Key 槽位，而不是走 OpenAI 地址。完整的型号 ID 和单价见模型页。
生成的配置能提交到团队项目里吗？
不要把带真实 Key 的文件提交到仓库。Claude Code 项目目录下的 .claude/settings.json 会随仓库共享给所有人，Key 应该放在个人的 ~/.claude/settings.json 或环境变量里。Codex 的服务商配置本来也只能写在用户目录的 ~/.codex/config.toml。
配好之后怎么确认请求真的走了 CCSub？
随便发一条消息，然后打开 CCSub 控制台的「使用记录」页，能看到这次请求的 model、输入输出和缓存 Token 数以及扣费，就说明链路已经接通。看不到记录，说明工具还在用别的地址或旧的环境变量。
