Claude Code 接入

把 Claude Code 接到 1折AI：用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN（环境变量或 settings.json），附 Windows 写法、模型映射、VS Code 插件和常见报错。

Claude Code 只需要两个变量：ANTHROPIC_BASE_URL 指向我们，ANTHROPIC_AUTH_TOKEN 填你的 API 密钥（API key）。不需要登录 Anthropic 账号。

最短路径

已经装好 Claude Code、手里有 API 密钥的话，把下面两行写进 ~/.claude/settings.json，然后运行 claude：

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
5
  }
6
}

文件已经存在的话，把这两项合并进已有的 env，不要覆盖其它配置。

完整步骤

安装 Claude Code
已经装过可以跳过。以下命令来自 Claude Code 官方安装文档：
macOS / Linux
Windows PowerShell
Homebrew
npm（需要 Node.js 22+）
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Homebrew
brew install --cask claude-code
npm（需要 Node.js 22+）
npm install -g @anthropic-ai/claude-code
用 npm 装时不要加 sudo。
拿到 API 密钥
在控制台新建一个 API 密钥，建议专门给这台机器的 Claude Code 用。见获取与管理 API 密钥。

配置（三选一）

settings.json 的位置：macOS / Linux 是 ~/.claude/settings.json，Windows 是 %USERPROFILE%\.claude\settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 持久写入当前用户，重开终端后生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")

# 只在当前窗口生效
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"

setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"

ANTHROPIC_BASE_URL 填根地址，不要加 /v1，Claude Code 会自己拼 /v1/messages。

启动并确认
在项目目录运行 claude，进去后输入 /status。看两行：
- base URL 一行显示 https://1zheai.com
- 凭据一行显示来源是 ANTHROPIC_AUTH_TOKEN
然后问一句话，再去调用日志看有没有新的记录。有，就接通了。
不想进交互界面的话，也可以用非交互模式试一次（2026-10-15 实测返回 ok）：
bash
```
1
claude -p "say ok" --model claude-sonnet-4-6
```

为什么用 ANTHROPIC_AUTH_TOKEN

Claude Code 有两个变量都能放 API 密钥，区别如下（官方说明）：

变量	发送方式	行为
`ANTHROPIC_AUTH_TOKEN`	`Authorization: Bearer <值>`	设置后立即生效，不弹确认
`ANTHROPIC_API_KEY`	`x-api-key: <值>`	交互模式下首次会弹窗问你是否使用这个 API 密钥

两种我们都支持，推荐 ANTHROPIC_AUTH_TOKEN。两个只设一个：如果系统里还留着以前官方的 ANTHROPIC_API_KEY，删掉它，免得混用出 401。

另外两条容易踩的规则：

settings.json 的 env 和终端 export 设了同一个变量时，以 settings.json 为准。改了终端变量没生效，先看 settings.json。
不要把 API 密钥写进项目的 .claude/settings.json，这个文件通常会提交进仓库。要按项目区分，用不提交的 .claude/settings.local.json。

模型映射

Claude Code 里的 opus、sonnet、haiku、fable 是别名，可以用环境变量指定它们对应的具体模型。Haiku 那一档还会被 Claude Code 用来跑一些后台小任务。

变量	作用	示例值
`ANTHROPIC_MODEL`	启动时使用的模型	`claude-sonnet-5-5`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`opus` 别名指向	`claude-opus-5-5`
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`sonnet` 别名指向	`claude-sonnet-5-5`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`haiku` 别名和后台任务用的模型	`claude-haiku-5-5`
`ANTHROPIC_DEFAULT_FABLE_MODEL`	`fable` 别名指向	`claude-fable-5-1`

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
5
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
6
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
7
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
8
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
9
  }
10
}

模型 ID 必须是支持的模型里的。运行中也可以用 /model claude-opus-5-5 临时切换。

VS Code 插件

Claude Code 的 VS Code 插件在启动前会检查凭据，官方建议把变量写在 VS Code 自己的用户设置里（命令面板 → Preferences: Open User Settings (JSON)）：

1
{
2
  "claudeCode.environmentVariables": [
3
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
4
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
5
  ]
6
}

只写在 ~/.claude/settings.json 时，插件自己的登录检查可能读不到。

可选设置

变量	作用
`API_TIMEOUT_MS`	请求超时，默认 600000（10 分钟），长任务容易超时可以调大
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`	关掉自动更新、遥测、错误上报等非必要流量。注意设成 `0` 或 `false` 也算开启，要关掉必须删除这个变量
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`	遇到 “Extra inputs are not permitted” 一类 400 时用
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`	让 `/model` 列表从 `/v1/models` 拉取可用模型

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 已实测可用（Claude Code 2.1.296，2026-10-15）：启动后 debug 日志里出现 [gatewayDiscovery] cached 14 models，14 个模型和支持的模型一致。

不要设置 DISABLE_PROMPT_CACHING，它会关掉缓存，账单会明显变高，见 Prompt Caching。

常见问题

一启动就是登录界面 / 提示 Please run /login

Claude Code 没读到 API 密钥。检查变量名拼写；用环境变量的话确认是在新开的终端里启动；用 settings.json 的话确认 JSON 格式正确（多一个逗号就会整体失效）。

401 / Invalid API key

API 密钥复制不完整，或者 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 同时存在且其中一个是旧值。两个只留一个。更多见错误码与排错。

404

ANTHROPIC_BASE_URL 多写了 /v1。改成 https://1zheai.com。

选的是 Opus，日志里有 Haiku 的调用

这是 Claude Code 用 Haiku 档跑后台小任务。想换成别的模型，设置 ANTHROPIC_DEFAULT_HAIKU_MODEL。

怎么在官方账号和 1折AI 之间切换？

删掉（或注释掉）上面两个变量就回到官方登录。经常切换的话用 CC Switch，点一下就换。

用 1折AI 会影响我的 Anthropic 账号吗？

不会产生关联。接入 1折AI 时 Claude Code 用的是我们的 API 密钥，不登录你的 Anthropic 账号。