> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sub2api.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置到 Claude Code CLI

> 将 Claude Code CLI 接入兼容 Anthropic API 的第三方服务。

## 开始前

请先确认你已经完成以下准备：

* 已在服务控制台创建 API 密钥
* 已确认当前机器使用的是 `zsh`、`bash` 或 PowerShell

## 配置步骤

### macOS / Linux / WSL

#### 当前终端临时生效

```bash theme={null}
export ANTHROPIC_BASE_URL="https://as.sub2api.dev"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

#### 永久生效

将以下内容写入 `~/.zshrc`：

```bash theme={null}
export ANTHROPIC_BASE_URL="https://as.sub2api.dev"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

加载配置：

```bash theme={null}
source ~/.zshrc
```

如果使用 `bash`，请改写入 `~/.bash_profile` 或 `~/.bashrc`。

#### 或者写入配置文件 `settings.json`

文件路径：

```text theme={null}
~/.claude/settings.json
```

示例：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://as.sub2api.dev",
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
```

### Windows

#### 当前终端临时生效

```powershell theme={null}
$env:ANTHROPIC_BASE_URL="https://as.sub2api.dev"
$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

#### 永久生效

在 Windows 环境变量中新增系统变量：

```text theme={null}
ANTHROPIC_BASE_URL="https://as.sub2api.dev"
ANTHROPIC_AUTH_TOKEN="你的API密钥"
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

#### 或者写入配置文件 `settings.json`

文件路径：

```text theme={null}
%userprofile%\.claude\settings.json
```

示例：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://as.sub2api.dev",
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
```

## 验证方式

配置完成后，建议执行以下验证：

1. 重新打开终端
2. 启动 Claude Code CLI
3. 发送一个简单问题，例如 `hi`
4. 若模型能正常返回结果，则说明配置成功

## 常见问题

### 环境变量和 `settings.json` 需要同时配置吗？

不需要，任选一种方式即可。

### 修改配置后为什么没有生效？

请先确认是否重新打开了终端，或是否执行了 `source ~/.zshrc` 等加载操作。

## 相关页面

* [Claude Code 接入概览](/claude-code/overview)
* [VSCode / Cursor 插件](/claude-code/vscode)
* [Claude Desktop](/claude-code/desktop)
* [常见报错](/help/common-errors)