---
url: https://limapi.com/docs/agents/claude-code.md
---
# Claude Code

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。通过 LimAPI 网关的 Anthropic 兼容端点，可以直接在 Claude Code 中使用平台接入的全部模型。

::: tip 懒人方式
不想手动改配置？使用 [LimAPI Agent 桌面客户端](/agents/limapi-agent) 可一键完成安装与配置。
:::

## 安装 Claude Code

### macOS / Linux

1. 安装或更新 Node.js（v18.0 或更高版本）。
2. 在终端中执行以下命令安装 Claude Code：

```bash
npm install -g @anthropic-ai/claude-code
```

3. 验证安装结果，输出版本号即表示安装成功：

```bash
claude --version
```

### Windows

在 Windows 上使用 Claude Code，需先安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行：

```bash
npm install -g @anthropic-ai/claude-code
```

> 详情参见 Claude Code 官方文档的 Windows 安装教程。

### 跳过登录验证

编辑或新建 `~/.claude.json`（Windows 路径：`C:\Users\<用户名>\.claude.json`），将 `hasCompletedOnboarding` 设为 `true`，跳过 Anthropic 官方登录验证：

```json
{
  "hasCompletedOnboarding": true
}
```

## 配置接入凭证

新建 `~/.claude/settings.json`（Windows 路径：`C:\Users\<用户名>\.claude\settings.json`），写入以下配置。将 `YOUR_API_KEY` 替换为你在 [Portal](https://limapi.com/) 创建的 API Key：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://limapi.com/api/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.8-max"
  }
}
```

| 环境变量 | 说明 |
|------|------|
| `ANTHROPIC_AUTH_TOKEN` | LimAPI API Key（`sk-` 开头） |
| `ANTHROPIC_BASE_URL` | LimAPI Anthropic 兼容端点，固定为 `https://limapi.com/api/anthropic` |
| `ANTHROPIC_MODEL` | 主模型 |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Claude Code 调用 Haiku 档时实际使用的模型 |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Sonnet 档映射模型 |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Opus 档映射模型 |
| `CLAUDE_CODE_SUBAGENT_MODEL` | 子任务（如文件搜索、Plan 模式）使用的模型，可按需替换 |

> 💡 模型映射可按需调整：各档默认模型可以映射为平台支持的任意模型，完整列表通过 `GET /api/v1/models` 查询或在 Portal 模型广场查看。

配置保存后，**新开一个终端窗口**执行：

```bash
claude "你好"
```

若模型正常返回响应，配置成功。如需进一步确认，在 Claude Code 中执行 `/status`，检查 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 是否正确指向 LimAPI 地址。

### 配置上下文窗口大小

Claude Code 默认使用 200K 上下文窗口。如果需要处理大型代码仓库或长对话，且所用模型支持更长上下文，可在 `~/.claude/settings.json` 的 `env` 字段中添加 `CLAUDE_CODE_MAX_CONTEXT_TOKENS`：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://limapi.com/api/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
  }
}
```

修改配置后，需新开终端窗口重新启动 Claude Code 使配置生效。

## 使用 CC Switch 一键切换

CC Switch 是社区开源的桌面 GUI，支持在多个 API Key 或供应商之间一键切换，无需手动修改 settings.json。

### 安装

* **macOS**：`brew tap farion1231/ccswitch && brew install --cask cc-switch`，或从 Releases 下载 `.dmg`
* **Windows**：从 Releases 下载 `.msi` 安装包或便携版 `.zip`
* **Linux**：Arch 发行版 `paru -S cc-switch-bin`；其他发行版从 Releases 下载 `.deb` / `.rpm` / `.AppImage`

### 添加供应商

1. 在 CC Switch 主界面顶部图标栏选中 Claude Code 图标，点击右上角 **+** 进入「添加新供应商」：

| 配置项 | 填写内容 |
|------|------|
| 供应商名称 | `LimAPI` |
| API Key | Portal 创建的 API Key |
| 请求地址 | `https://limapi.com/api/anthropic` |

2. 展开高级选项配置模型映射，将主模型与 Haiku、Sonnet、Opus 默认模型设置为平台支持的模型（如 `claude-sonnet-4-6`、`claude-opus-5`）。
3. 回到主界面，点击该供应商右侧「启用」按钮，然后新开一个 Claude Code 会话使配置生效。

## Claude Code IDE 插件

完成上述 CLI 配置后，在 IDE 中安装 Claude Code 插件，可直接复用 `settings.json` 中的配置。

### VS Code

1. 在扩展市场搜索 **Claude Code for VS Code** 并安装。
2. 重启 VS Code，点击右上角图标进入 Claude Code。
3. 在对话框中输入 `/`，选择 General config，在 Selected Model 中设置模型。

### JetBrains

1. 在扩展市场搜索 **Claude Code** 并安装。
2. 重启 IDE，点击右上角图标即可使用。

## 常见问题

### 启动后提示 "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com"

此错误表示 Claude Code 正在尝试连接 Anthropic 官方服务而非 LimAPI。通常是环境变量未正确配置或未生效。按以下步骤排查：

1. **检查配置**：启动 Claude Code 后执行 `/status` 命令，确认 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 是否正确指向 LimAPI 地址。输出为空或指向其他地址时，检查 settings.json 配置。
2. **确认 hasCompletedOnboarding**：检查 `~/.claude.json` 中 `hasCompletedOnboarding` 是否设置为 `true`。未设置时，Claude Code 启动后会尝试连接 Anthropic 官方服务进行登录验证。
3. **重新打开终端**：修改配置文件后，需要新开一个终端窗口再执行 `claude`，配置才会生效。
4. **更新 Claude Code**：若以上步骤均无效，可能是版本过旧。执行 `npm install -g @anthropic-ai/claude-code@latest` 更新后重试。

### 长思考模型中途断流

LimAPI 网关已针对长思考模型（如 Claude 深度思考）优化流式超时策略（首包超时与包间空闲超时分离配置）。若仍偶发断流，请检查本地网络代理对 SSE 长连接的超时设置。

### CC Switch 提示 "未找到可用的模型列表端点"

该提示来自 CC Switch 保存供应商时的连通性检查——它会探测模型列表端点（如 `/v1/models`）。Anthropic 兼容端点仅提供对话接口，模型列表请使用 OpenAI 兼容端点 `https://limapi.com/api/v1/models` 查询。该提示不影响正常使用，可忽略。

### 图片粘贴

Claude Code 支持直接粘贴图片进行多模态对话（网关会自动转换为模型可识别的格式），需要所用模型具备视觉能力。