Claude Code

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

懒人方式

不想手动改配置？使用 LimAPI Agent 桌面客户端 可一键完成安装与配置。

安装 Claude Code

macOS / Linux

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

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

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

claude --version

Windows

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

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

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

跳过登录验证

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

{
  "hasCompletedOnboarding": true
}

配置接入凭证

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

{
  "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 模型广场查看。

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

claude "你好"

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

配置上下文窗口大小

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

{
  "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 支持直接粘贴图片进行多模态对话（网关会自动转换为模型可识别的格式），需要所用模型具备视觉能力。