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

# Claude Code 集成

> 在 Claude Code 中配置 APIAny.AI API Key、Base URL 和推荐模型。

[Claude Code](https://claude.ai/code) 可以通过环境变量或本地配置文件连接 APIAny.AI。适合在终端、编辑器和自动化开发流程中使用统一模型接口。

## 准备工作

* 已安装 Claude Code。
* 已在 [APIAny.AI 控制台](https://apiany.ai/zh/dashboard/api-keys) 创建 API Key。
* 已准备一个要使用的模型 ID。

## 安装

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

## 使用 settings.json 配置

在 `~/.claude/settings.json` 中写入：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiany.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

保存后重启 Claude Code。你也可以用环境变量临时测试：

```bash theme={null}
export ANTHROPIC_BASE_URL="https://apiany.ai"
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
claude
```

## 推荐模型

| 模型 ID               | 适用场景                        |
| ------------------- | --------------------------- |
| `gpt-5.5`           | 适合复杂推理、编码和生产级工作流，优先推荐。      |
| `gpt-5.4`           | 适合高级对话、Agent 和通用生产任务。       |
| `gpt-5.4-mini`      | 速度、质量和成本均衡，适合日常高频使用。        |
| `gpt-4o-mini`       | 适合简单对话、翻译和轻量任务，速度快、成本低。     |
| `claude-sonnet-4-6` | 适合 Claude 兼容配置的长文本、写作和编码任务。 |
| `gemini-3.5-flash`  | 适合 Gemini 兼容配置的快速多模态任务。     |

## 操作截图

以下截图展示 Claude Code 中的关键配置入口和保存后的使用界面。截图中的 API 地址和名称均已按 APIAny.AI 调整。

### 步骤 1

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/claude-code/claude-code-cli.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=11752b888792a51a62473fb464e682a0" alt="Claude Code 配置截图 1" width="2574" height="360" data-path="images/integrations/claude-code/claude-code-cli.png" />

## 常见问题

### 返回 401 或认证失败

确认 API Key 已完整复制，前后没有多余空格，并且已经在 APIAny.AI 控制台中启用。

### 模型无法选择或调用失败

手动输入模型 ID，并确认该模型在 [模型目录](/zh/models/chat-models) 中可用。不同工具可能不会自动拉取模型列表。

### Base URL 应该怎么填

OpenAI 兼容配置通常使用 `https://apiany.ai/v1`；Claude 兼容配置通常使用 `https://apiany.ai`；需要完整接口地址的工具使用 `https://apiany.ai/v1/chat/completions`。