Claude Code 国内使用教程:配置 API 中转
Claude Code 默认要登录 Anthropic 账号,国内网络也连不上官方接口。把它的接口地址换成中转站、填上中转站的密钥,就能直接使用,不需要 Anthropic 账号,也不用开代理。下面以 T7 API 为例,其他中转站的做法相同,只是地址和密钥不同。
https://api.t7api.com末尾不要加 /v1sk-…在本站「API 密钥」里新建第 1 步:安装 Claude Code
已经装好的跳过。国内网络建议先装 Node.js 22 或更高版本,再用 npm 国内镜像安装:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
运行 claude --version 能看到版本号就装好了。Windows 上遇到「禁止运行脚本」「npm 无法识别」等问题,见 Claude Code 国内安装教程。
第 2 步:填接口地址和密钥
Windows:一行命令配置
打开 PowerShell,运行下面这行,按提示粘贴你的 sk- 密钥:
irm https://t7api.com/cc.ps1 | iex
这行命令报错(比如提示无法建立安全通道,多见于较老的 Windows)时,先运行下面这行再试;还不行,用 接入教程 里的「Windows 整段粘贴」版,效果相同。
[Net.ServicePointManager]::SecurityProtocol = 'Tls12'
macOS / Linux:一行命令配置
打开终端,运行下面这行,按提示粘贴密钥(粘贴后不显示,直接回车):
curl -fsSL https://t7api.com/cc.sh | bash
脚本会把接口地址和密钥写进 ~/.claude/settings.json(原有内容保留,并另存备份)、跳过首次启动时的官方登录检查、清除以前别家中转留下的旧变量,最后测试密钥是否有效。它不会安装或删除任何软件。看到全部显示「完成」就可以用了。
手动写配置文件
配置写在用户目录下的 .claude/settings.json:
| 系统 | 文件位置 |
|---|---|
| Windows | C:\Users\你的用户名\.claude\settings.json |
| macOS / Linux | ~/.claude/settings.json |
注意用户目录下还有一个名字很像的 .claude.json,不是这个文件。文件是空的或不存在时,写入下面的内容,把 sk-你的密钥 换成自己的:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.t7api.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
最后一行关闭自动更新和统计上报:这些连接在国内网络下会失败、拖慢启动,关掉不影响使用。
文件里已经有别的内容(比如 "theme": "dark")时,把 "env" 这一块加进最外层那对大括号里面,并在上一项末尾补逗号;已经有 "env" 的,只把这三行加进去,不要写第二个 "env"。
不要把密钥写进某个项目目录下的 .claude/settings.json,那样容易被提交到 Git。
只在当前终端临时用
# macOS / Linux
export ANTHROPIC_BASE_URL=https://api.t7api.com
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥
claude# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.t7api.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude
关掉终端就失效。
第 3 步:验证
claude -p "回复 ok"
能看到回复就成功了。进入 Claude Code 后输入 /status,应能看到 Anthropic base URL 是 https://api.t7api.com,凭据来源是 ANTHROPIC_AUTH_TOKEN。如果显示的是 claude.ai 登录,说明配置没生效,见 常见报错。
VS Code / JetBrains 插件
VS Code 插件自己的登录检查读不到 settings.json 里的 env,还要在 VS Code 的用户设置(settings.json)里加:
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.t7api.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" }
]
JetBrains 插件调用的是终端里的 claude,按第 2 步配好即可。
选择模型
在 Claude Code 里输入 /model 切换。本站开放的模型以 模型价格 页为准,常用:
| 模型 | 适合 | 输入 / 输出(每百万 tokens) |
|---|---|---|
claude-opus-5-5 | 复杂任务,效果最好 | ¥5.6 / ¥28 |
claude-sonnet-5-5 | 日常编码,速度和效果均衡 | ¥2.8 / ¥14 |
claude-haiku-5-5 | 简单任务,最便宜 | ¥0.14 / ¥0.7 |
Claude Code 会自动使用提示缓存,重复发送的上下文按「缓存读取」计费(每百万 tokens:Opus 5.5 ¥0.28、Sonnet 5.5 ¥0.14),比普通输入便宜得多。每次请求的实际扣费都能在本站「使用日志」里查到。