T7 API
首页 / 教程 / Claude Code 国内使用教程:配置 API 中转

Claude Code 国内使用教程:配置 API 中转

更新于 2026-11-19

Claude Code 默认要登录 Anthropic 账号,国内网络也连不上官方接口。把它的接口地址换成中转站、填上中转站的密钥,就能直接使用,不需要 Anthropic 账号,也不用开代理。下面以 T7 API 为例,其他中转站的做法相同,只是地址和密钥不同。

接口地址https://api.t7api.com末尾不要加 /v1
密钥sk-…在本站「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:

系统文件位置
WindowsC:\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),比普通输入便宜得多。每次请求的实际扣费都能在本站「使用日志」里查到。