Claude Code 接入 CCSub：ANTHROPIC_BASE_URL 和 Token 怎么配置

echo 'export ANTHROPIC_BASE_URL="https://www.ccsub.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc
claude

Claude Code 是 Anthropic 官方的终端编程助手，它只认 Anthropic 协议。接入 CCSub 不需要改代码，也不需要登录 Claude 账号，只要告诉它两件事：请求发到哪里（ANTHROPIC_BASE_URL），用哪个凭证（ANTHROPIC_AUTH_TOKEN）。

两个环境变量的含义

最常见的错误是给地址加上 /v1。Claude Code 发请求时会自己拼上 /v1/messages，所以 https://www.ccsub.net 最终请求的是 https://www.ccsub.net/v1/messages；如果你填了 https://www.ccsub.net/v1，实际请求就变成 /v1/v1/messages，结果是报错或一直连不上。

macOS / Linux 配置

先确认你用的是哪个 shell：在终端执行 echo $SHELL，结果以 zsh 结尾就改 ~/.zshrc，以 bash 结尾就改 ~/.bashrc。下面以 zsh 为例：

echo 'export ANTHROPIC_BASE_URL="https://www.ccsub.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

执行完用 echo $ANTHROPIC_BASE_URL 检查一下，能打印出地址就说明当前窗口已经生效。

Windows 配置（PowerShell）

Windows 推荐写进「用户环境变量」，这样所有新开的终端都能读到：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://www.ccsub.net', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-你的密钥', 'User')

设置后关闭所有 PowerShell 和终端窗口再重新打开，旧窗口不会刷新变量。如果你是在 VS Code、Cursor 这类编辑器的内置终端里运行 claude，要把整个编辑器退出重开。

用 settings.json 配置

不想动系统环境变量，可以把变量写进 Claude Code 自己的配置文件 ~/.claude/settings.json（Windows 路径是 %USERPROFILE%\.claude\settings.json）。这个文件对所有项目生效，后台运行的会话也会读取：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ccsub.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

文件里原本有其他配置的话，只把 env 这一段合并进去，注意 JSON 的逗号。同一个变量在 shell 和 settings.json 里都设了的话，以 settings.json 为准，改了 shell 却不生效时先查这里。

只想在某个项目里走 CCSub，可以写进项目目录的 .claude/settings.local.json。不要写进项目的 .claude/settings.json：那个文件通常会提交进 Git，Key 会跟着泄露。另外，项目级配置要等你在首次启动时信任这个目录之后才生效。

VS Code 插件单独配置

Claude Code 的 VS Code 插件在启动前会先检查一次凭证，这一步读不到 ~/.claude/settings.json。官方文档的做法是写进 VS Code 的用户设置：命令面板执行 Preferences: Open User Settings (JSON)，加入：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://www.ccsub.net" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" }
  ]
}

启动并确认走的是 CCSub

cd ~/你的项目
claude

首次进入会有几个引导选项，一路回车即可。进入后输入 /model 可以切换型号；model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。

确认请求确实发到了 CCSub，有两个办法：

1. 在 Claude Code 里执行 /status。Status 页里出现 Anthropic base URL 一行、值是 https://www.ccsub.net，并且有一行 Auth token 指向 ANTHROPIC_AUTH_TOKEN，说明地址和凭证都生效了。没有这一行，就是变量没传进当前会话。
2. 看账单：发一句话，再打开 CCSub 控制台的「使用记录」，能看到刚才的请求和 Token 数，链路就打通了。

进 Claude Code 之前，也可以先用 curl 单独测一下地址和 Key。返回一段以 {"id":"msg_ 开头的 JSON 说明一切正常，返回 401 说明 Key 不对：

curl -sS -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

想在多个服务之间来回切换？

如果你既用 CCSub 也用其他 API 服务，每次改环境变量很麻烦，可以用图形化工具 CC Switch 管理，它的预设列表里就有 CCSub。Codex CLI 的配置方法见 Codex CLI 接入教程，包括 Node.js 在内的完整安装步骤见 安装配置文档。

计费提醒

Claude Code 每一轮对话都会带上之前的上下文，长会话的输入 Token 会越积越多。CCSub 普通用户的缓存读写按输入价计费，所以话题切换时用 /clear 清空、长对话用 /compact 压缩上下文，是最直接的省钱办法。每次请求的扣费明细都能在「使用记录」里查到。