---
title: Claude Code 接入
description: 把 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`：

```json title="~/.claude/settings.json"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```

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

## 完整步骤

<Steps>
<Step title="安装 Claude Code">

已经装过可以跳过。以下命令来自 [Claude Code 官方安装文档](https://code.claude.com/docs/en/setup)：

<CodeGroup>
```bash title="macOS / Linux"
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell title="Windows PowerShell"
irm https://claude.ai/install.ps1 | iex
```
```bash title="Homebrew"
brew install --cask claude-code
```
```bash title="npm（需要 Node.js 22+）"
npm install -g @anthropic-ai/claude-code
```
</CodeGroup>

用 npm 装时不要加 `sudo`。

</Step>
<Step title="拿到 API 密钥">

在[控制台](https://1zheai.com/console)新建一个 API 密钥，建议专门给这台机器的 Claude Code 用。见[获取与管理 API 密钥](/docs/api-keys/)。

</Step>
<Step title="配置（三选一）">

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

<CodeGroup>
```json title="settings.json（推荐）"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```
```bash title="macOS / Linux 环境变量"
# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
```
```powershell title="Windows PowerShell"
# 持久写入当前用户，重开终端后生效
[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"
```
```bat title="Windows CMD"
setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
```
</CodeGroup>

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

</Step>
<Step title="启动并确认">

在项目目录运行 `claude`，进去后输入 `/status`。看两行：

- base URL 一行显示 `https://1zheai.com`
- 凭据一行显示来源是 `ANTHROPIC_AUTH_TOKEN`

然后问一句话，再去[调用日志](/docs/usage-logs/)看有没有新的记录。有，就接通了。

不想进交互界面的话，也可以用非交互模式试一次（2026-10-15 实测返回 `ok`）：

```bash
claude -p "say ok" --model claude-sonnet-4-6
```

</Step>
</Steps>

## 为什么用 ANTHROPIC_AUTH_TOKEN

Claude Code 有两个变量都能放 API 密钥，区别如下（[官方说明](https://code.claude.com/docs/en/authentication)）：

| 变量 | 发送方式 | 行为 |
|---|---|---|
| `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` |

```json title="~/.claude/settings.json（带模型映射）"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}
```

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

## VS Code 插件

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

```json title="VS Code settings.json"
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
  ]
}
```

只写在 `~/.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 个模型和[支持的模型](/docs/models/)一致。

不要设置 `DISABLE_PROMPT_CACHING`，它会关掉缓存，账单会明显变高，见 [Prompt Caching](/docs/prompt-caching/)。

## 常见问题

<AccordionGroup>
<Accordion title="一启动就是登录界面 / 提示 Please run /login">

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

</Accordion>
<Accordion title="401 / Invalid API key">

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

</Accordion>
<Accordion title="404">

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

</Accordion>
<Accordion title="选的是 Opus，日志里有 Haiku 的调用">

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

</Accordion>
<Accordion title="怎么在官方账号和 1折AI 之间切换？">

删掉（或注释掉）上面两个变量就回到官方登录。经常切换的话用 [CC Switch](/docs/quickstart-cc-switch/)，点一下就换。

</Accordion>
<Accordion title="用 1折AI 会影响我的 Anthropic 账号吗？">

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

</Accordion>
</AccordionGroup>