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

# Claude Code 接入 APIONE

> 设置 Anthropic 兼容地址，在终端与 VS Code 中使用 APIONE。

Claude Code 通过 Anthropic Messages 协议连接 APIONE。先在终端验证基础会话，再将同样的连接信息用于编辑器。

## 安装与准备

按 Claude Code 官方安装说明安装客户端，运行 `claude doctor` 检查环境。在 [APIONE 控制台](https://apione.ai/zh/app/api-keys)准备密钥，并选择支持 Messages 与工具调用的模型。

## 终端配置

macOS、Linux 或 WSL：

```bash theme={null}
export ANTHROPIC_BASE_URL="https://api.apione.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_APIONE_KEY"
unset ANTHROPIC_API_KEY
export ANTHROPIC_MODEL="YOUR_APIONE_MODEL_ID"
claude
```

Windows PowerShell：

```powershell theme={null}
$env:ANTHROPIC_BASE_URL="https://api.apione.ai"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIONE_KEY"
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
$env:ANTHROPIC_MODEL="YOUR_APIONE_MODEL_ID"
claude
```

替换两个占位符。基础地址不附加 `/v1` 或 `/messages`。以上只影响当前终端；确认成功后，可按自己的 Shell 配置持久化。切回原服务时恢复原有环境配置。

## 检查是否生效

在新会话中运行 `/status` 查看连接信息，再发送“只回复 OK”。以 APIONE 控制台的实际请求记录确认链路，不依赖模型自报名称。可用 `/model` 切换模型。需要固定档位时，再配置 `ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL` 和 `ANTHROPIC_DEFAULT_OPUS_MODEL`。

![Claude Code 终端回复界面。可到 APIONE 用量页核对实际请求。](https://mintcdn.com/apione/eGTb2vS-514SNt6Q/images/integrations/screenshots/claude-code-terminal.png?fit=max\&auto=format\&n=eGTb2vS-514SNt6Q\&q=85\&s=8345d2c6ef1b5193149a373925260bf8)

Claude Code 终端回复界面。可到 APIONE 用量页核对实际请求。

## VS Code 扩展

在 VS Code 中安装 Claude Code 扩展，填写 APIONE 接口地址、API Key 和模型 ID，即可通过 APIONE 调用模型。

### 1. 安装 Claude Code 扩展

打开 VS Code 扩展商店，搜索 **Claude Code**，安装由 **Anthropic** 发布的 **Claude Code for VS Code**，扩展标识符为 `anthropic.claude-code`。安装后若提示 **重新启动扩展**，点击完成重启。

![VS Code 扩展商店中的 Claude Code 安装页面](https://mintcdn.com/apione/OyYiEY31YyCo4SOx/images/integrations/screenshots/claude-code-vscode-install.png?fit=max\&auto=format\&n=OyYiEY31YyCo4SOx\&q=85\&s=02388ea4e789356a3bdc4fd074bfaeae)

在 VS Code 扩展商店安装官方 Claude Code 扩展。

### 2. 打开用户配置

打开扩展设置，找到 **Claude Code: Environment Variables**，点击 **在 settings.json 中编辑**。

也可以按 `Ctrl+Shift+P`，运行 **Preferences: Open User Settings (JSON)**（首选项：打开用户设置 JSON）。

![Claude Code 环境变量的 JSON 配置入口](https://mintcdn.com/apione/OyYiEY31YyCo4SOx/images/integrations/screenshots/claude-code-vscode-settings-entry.png?fit=max\&auto=format\&n=OyYiEY31YyCo4SOx\&q=85\&s=1db3c3f0573ca068ceff32cf30aad31d)

点击“在 settings.json 中编辑”，打开用户配置文件。

### 3. 填写 APIONE 连接信息

将以下配置合并到用户设置的最外层对象中。已有 `claudeCode.environmentVariables` 时，更新同一个数组中的对应项。

```json theme={null}
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.apione.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_APIONE_KEY"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_APIONE_MODEL_ID"
    }
  ]
}
```

| 配置项 | 填写内容 |
| - | - |
| `ANTHROPIC_BASE_URL` | APIONE 接口地址 `https://api.apione.ai` |
| `ANTHROPIC_AUTH_TOKEN` | 在 [APIONE 密钥页](https://apione.ai/zh/app/api-keys)创建的 API Key |
| `ANTHROPIC_MODEL` | 当前 Key 可调用、支持 Anthropic Messages 和工具调用的实际模型 ID |

将 `YOUR_APIONE_KEY` 和 `YOUR_APIONE_MODEL_ID` 替换为真实值，保留用户设置中的其他配置，保存文件。

### 4. 设置模型档位（可选）

需要为 Haiku、Sonnet、Opus 档位分别指定模型时，在上方的 `claudeCode.environmentVariables` 数组中追加对应项。

```json theme={null}
[
  {"name":"ANTHROPIC_DEFAULT_HAIKU_MODEL","value":"YOUR_HAIKU_MODEL_ID"},
  {"name":"ANTHROPIC_DEFAULT_SONNET_MODEL","value":"YOUR_SONNET_MODEL_ID"},
  {"name":"ANTHROPIC_DEFAULT_OPUS_MODEL","value":"YOUR_OPUS_MODEL_ID"}
]
```

每个占位符均填写 APIONE 实际模型 ID。切换档位后，可在 APIONE 请求明细中核对实际调用的模型。

### 5. 设置操作权限（可选）

在扩展设置的 **Initial Permission Mode** 中选择新会话使用的权限确认方式。首次使用可保持 `default`，根据任务需要确认文件修改与命令执行。

![Claude Code 初始操作权限设置](https://mintcdn.com/apione/OyYiEY31YyCo4SOx/images/integrations/screenshots/claude-code-vscode-permission-mode.png?fit=max\&auto=format\&n=OyYiEY31YyCo4SOx\&q=85\&s=05a1a7ddd7fe574faaed4195d8520d43)

通过 Initial Permission Mode 设置新会话的操作权限。

已完成 APIONE 鉴权配置时，可按需启用 **Disable Login Prompt**，控制扩展登录提示的显示。

### 验证 APIONE 连接

1. 保存用户设置，运行 **Developer: Reload Window**（开发人员：重新加载窗口）。
2. 打开 Claude Code 面板并创建新会话，发送“只回复 OK”。
3. 进入 [APIONE 控制台](https://apione.ai/zh/app)，找到本次请求，核对调用时间、模型、状态及用量。
4. 基础对话成功后，再测试读取项目文件、修改代码等实际工作任务。

若出现错误，先核对地址、密钥和模型 ID。终端正常而扩展失败时，检查用户设置中的连接信息，以及启动 VS Code 时继承的环境变量。完整密钥应保存在用户级设置中。

## 排错

401 优先检查密钥与重复鉴权；404 检查地址与模型 ID；工具调用失败则核对模型能力和请求字段。上下文长度、推理参数及实验功能需逐项确认，不能由模型名称推断。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.