Claude Code 中转介绍

手动配置

Claude Code CLI 与 VSCode 插件的环境变量与 settings.json 配置（macOS / Linux / Windows CMD / PowerShell）。

懒人方案：不想手动改？用 CC-Switch 图形化配置一键搞定。下面是手动配置完整参考。

必填三个环境变量

变量	值
`ANTHROPIC_BASE_URL`	`https://nexor.nexoraivision.com`
`ANTHROPIC_AUTH_TOKEN`	你的 API Key（`sk-xxxx`）
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	`1`（关闭遥测）

官方变量名是 ANTHROPIC_API_KEY，但 Claude Code 推荐用 ANTHROPIC_AUTH_TOKEN（中转专用，不会被误传给官方）。两者都能用，选其一即可。

一、Claude Code CLI

macOS / Linux

export ANTHROPIC_BASE_URL="https://nexor.nexoraivision.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

把上面三行追加到 shell 配置文件：

# Bash
cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_BASE_URL="https://nexor.nexoraivision.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
source ~/.bashrc

# Zsh（macOS 默认）
cat >> ~/.zshrc << 'EOF'
export ANTHROPIC_BASE_URL="https://nexor.nexoraivision.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
source ~/.zshrc

# Fish
set -Ux ANTHROPIC_BASE_URL "https://nexor.nexoraivision.com"
set -Ux ANTHROPIC_AUTH_TOKEN "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
set -Ux CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

Windows CMD

set ANTHROPIC_BASE_URL=https://nexor.nexoraivision.com
set ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

用 setx 写入用户环境变量（重开终端生效）：

setx ANTHROPIC_BASE_URL "https://nexor.nexoraivision.com"
setx ANTHROPIC_AUTH_TOKEN "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

或：Win+R → sysdm.cpl → 高级 → 环境变量 → 新建用户变量。

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://nexor.nexoraivision.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

# 打开 PowerShell 配置文件
if (!(Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
notepad $PROFILE

在文件末尾追加：

$env:ANTHROPIC_BASE_URL="https://nexor.nexoraivision.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

保存后重开 PowerShell 即生效。

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://nexor.nexoraivision.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

此方式所有终端（CMD / PowerShell / WSL）都生效。

二、本机配置文件（settings.json + config.json）

VSCode 插件只读本机配置文件（不继承终端环境变量），CLI 同时也支持本机配置文件作为补充。涉及两个文件：

文件	作用
`~/.claude/settings.json`	核心配置：env 块 + apiKeyHelper
`~/.claude/config.json`	主配置：Claude Code 内部行为开关

1. 找到 `.claude` 配置目录

平台	路径	快速打开
macOS / Linux	`~/.claude`	Finder 按 `Cmd+Shift+G`，输入 `~/.claude` 回车
Windows	`%USERPROFILE%\.claude`	按 `Win+R`，输入 `%USERPROFILE%\.claude` 回车

目录不存在？ 在终端跑一次 claude 命令，Claude Code 启动时会自动创建该目录。也可以手动建：

macOS / Linux：mkdir -p ~/.claude
Windows：在资源管理器手动新建 .claude 文件夹（注意前面那个点）

2. 配置 settings.json（核心）

创建或编辑 ~/.claude/settings.json，推荐完整模板：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://nexor.nexoraivision.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的 API Key",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "apiKeyHelper": "echo 'sk-替换为你的 API Key'"
}

字段说明

字段	必填	说明
`env.ANTHROPIC_BASE_URL`	✅	中转地址：`https://nexor.nexoraivision.com`
`env.ANTHROPIC_AUTH_TOKEN`	✅	你的 API Key
`env.ANTHROPIC_DEFAULT_HAIKU_MODEL`	推荐	Claude Code 内部「轻任务」路由到的模型 ID
`env.ANTHROPIC_DEFAULT_OPUS_MODEL`	推荐	Claude Code 内部「难任务」路由到的模型 ID
`env.ANTHROPIC_DEFAULT_SONNET_MODEL`	推荐	Claude Code 内部「日常任务」路由到的模型 ID
`env.ANTHROPIC_MODEL`	推荐	默认对话模型（启动时选中）
`env.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	推荐	`"1"` 关闭遥测、版本检查等无关流量
`env.CLAUDE_CODE_ATTRIBUTION_HEADER`	推荐	`"0"` 不把请求标记为 Claude Code（中转优化用）
`env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	可选	`"1"` 启用最新的 Agent Teams 实验功能
`apiKeyHelper`	关键	在 settings.json 最外层（与 env 同级），见下方说明

所有值都是字符串类型（包括 "1" / "0"），不要写成数字 1 / 0。

⚠️ apiKeyHelper 是什么 — 一个经典踩坑点

某些「一键脚本」配置后，运行 claude 仍会尝试连接 api.anthropic.com 并报 ERR_BAD_REQUEST —— 多半是缺少 apiKeyHelper。

apiKeyHelper 是 Claude Code 读取密钥的辅助命令，写在 settings.json 最外层（与 env 同级，不是嵌在 env 里）：

{
  "env": { ... },
  "apiKeyHelper": "echo 'sk-替换为你的 API Key'"
}

Windows 上的 apiKeyHelper 存在已知 bug：一键脚本默认不含该字段。如果配置后仍无法使用，可尝试 删除该字段并重启，或改用 CC-Switch 图形化配置。

3. 配置 config.json（主配置）

创建或编辑 ~/.claude/config.json：

{
  "primaryApiKey": "any"
}

已有 config.json 且内容不止一行？先备份再修改，避免影响你其他配置：

cp ~/.claude/config.json ~/.claude/config.json.bak

primaryApiKey: "any" 让 Claude Code 跳过对官方 Anthropic 账号 Key 格式的强校验，允许使用中转 Key。不写这个字段，新版 Claude Code 可能拒绝中转 Key。

4. 重启并验证

改完两个配置文件，关掉所有终端窗口 / 重启 VSCode（环境变量与配置在已运行进程里是缓存的），然后：

claude
> 你好

正常回复即说明配置生效。如果还连不上，参考故障排查。

三、所有可用环境变量

中转必备

变量	作用
`ANTHROPIC_BASE_URL`	API 中转地址（必填）
`ANTHROPIC_AUTH_TOKEN`	中转 Key（推荐用这个）
`ANTHROPIC_API_KEY`	官方 Key 变量名（也兼容，二选一）

模型路由

变量	作用
`ANTHROPIC_MODEL`	默认对话模型（启动时选中）
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Claude Code 内部「轻任务」路由到的模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Claude Code 内部「难任务」路由到的模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Claude Code 内部「日常任务」路由到的模型
`ANTHROPIC_SMALL_FAST_MODEL`	旧版变量，等价于 DEFAULT_HAIKU_MODEL

行为控制

变量	作用
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	`1` 关闭遥测 / 版本检查
`CLAUDE_CODE_ATTRIBUTION_HEADER`	`0` 关闭归属标记
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	`1` 启用 Agent Teams 实验功能
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	单次最大输出 Token
`HTTP_PROXY` / `HTTPS_PROXY`	走 HTTP 代理（一般不需要）

四、验证配置

# 检查环境变量
echo $ANTHROPIC_BASE_URL          # macOS/Linux
echo $env:ANTHROPIC_BASE_URL      # PowerShell
echo %ANTHROPIC_BASE_URL%         # Windows CMD

# 运行 Claude
claude --version
claude "你好"

如果还连不上，参考故障排查。

五、配置生效优先级

Claude Code 按以下顺序读取配置，靠前的覆盖靠后的：

命令行参数（如 --api-key）
进程环境变量（export / set / $env:）
~/.claude/settings.json（VSCode 插件强制走这里）
项目级 .claude/settings.json（如果存在）

如果你同时设了环境变量和 settings.json，环境变量优先。CLI 用的就是这套逻辑。

安装与环境检查

安装 Claude Code CLI 与必备环境（Node.js、Git）的步骤。

CC-Switch 一键配置

用 CC-Switch 图形化工具 5 分钟完成 Claude Code 中转配置，无需手改 settings.json。