登录
文档Claude Code

Claude Code

可通过 CC Switch 一键导入，或使用 Claude Code 用户级 settings.json 配置文件手动接入。

1. 准备 API Key 和模型

  1. 1
    在 API Key 页面 创建或复制密钥。
  2. 2
    在 模型定价页面 复制一个支持 Anthropic Messages 接口的准确模型 ID。
  3. 3
    更新 Claude Code，避免旧版本缺少网关或模型配置能力。
终端
claude update

2. 使用 CC Switch 一键导入

  1. 1
    从 CC Switch 发布页 安装并打开 CC Switch。查看截图示例
    CC Switch 发布页安装包列表
    在发布页选择适合自己设备的安装包。
  2. 2
    在 API Key 页面 打开密钥的操作菜单，选择 CC Switch 导入。查看截图示例
    打开 CC Switch 导入入口
    创建密钥后打开 CC Switch 导入入口。
  3. 3
    客户端选择 Claude，模型选择刚才确认的 Claude 模型。查看截图示例
    打开 CC Switch 导入对话框
    允许浏览器打开 ccswitch:// 链接后查看导入对话框。
  4. 4
    保留生成的服务根地址 https://ikun.love，不要手动添加 /v1；详细说明可查看 CC Switch 一键导入指南。查看截图示例
    确认 CC Switch 导入信息
    导入前检查服务商、模型和端点信息。
  5. 5
    在 CC Switch 中保存并启用服务商，然后完全退出并重新打开 Claude Code。查看截图示例
    启用导入后的 CC Switch 配置
    导入成功后启用配置并重启 Agent。

3. 手动配置

3.1 在用户 settings.json 中直接保存密钥

用户配置对所有项目生效，也能被 Claude Code 的后台 Agent 读取。不同系统的用户配置文件路径如下：

Windows
%USERPROFILE%\.claude\settings.json
macOS / Linux
~/.claude/settings.json

将以下字段合并到现有 JSON 中，不要删除原有的权限、插件或 MCP 配置：

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ikun.love",
    "ANTHROPIC_AUTH_TOKEN": "此处替换为 API Key"
  },
  "model": "此处替换为准确的模型 ID"
}

这里的 env 是 Claude Code 配置文件中的字段；保存后由 Claude Code 在新会话中加载，不需要再在终端里手动设置这些配置项。

3.2 为什么 Base URL 不带 /v1

Claude Code 会在ANTHROPIC_BASE_URL后请求/v1/messages。如果 Base URL 已经包含 /v1，最终可能形成重复路径并返回 404。

Claude Code 配置文件中的凭据字段与请求头对应关系如下：

配置字段请求头适用场景
ANTHROPIC_AUTH_TOKENAuthorization: Bearer ...All Token API、Bearer Token 网关
ANTHROPIC_API_KEYx-api-key: ...明确要求 Anthropic x-api-key 的网关

4. 启动并验证

  1. 1
    启动 claude；用户级配置会对新会话生效，不依赖特定终端。
  2. 2
    如果出现登录页，说明网关凭据没有被读取；不要选择 Claude 订阅登录，先检查配置文件路径和 JSON 格式。
  3. 3
    进入会话后运行 /status，核对服务地址、认证字段和当前模型。
  4. 4
    发送一个简短测试请求，再到 使用日志 确认请求模型和状态。

在/status中应确认以下内容：

  • Anthropic base URL 为 https://ikun.love；
  • Auth token or API key 显示ANTHROPIC_AUTH_TOKEN；
  • 当前模型为预期的准确模型 ID。

也可以在启动时临时指定模型：

终端
claude --model "此处替换为准确的模型 ID"

5. 常见问题

启动后仍要求登录

  • 确认配置写在 ~/.claude/settings.json，而不是其他同名文件。
  • 确认 env 位于 JSON 顶层。
  • 运行 /logout 可清除与网关凭据冲突的历史登录状态。

401、Unauthorized 或 Incorrect API key

  • 确认密钥没有多余空格或引号。
  • All Token API 应使用 ANTHROPIC_AUTH_TOKEN，不要误用只发送 x-api-key 的ANTHROPIC_API_KEY。
  • 确认密钥未过期，并在API Key 页面检查其分组和模型权限。

404 Not Found

  • ANTHROPIC_BASE_URL 应为 https://ikun.love，不要带 /v1 或 /v1/messages。
  • 所选模型必须支持 Anthropic Messages 接口。

模型不可用

  • 使用模型定价页面显示的完整模型 ID，不要使用展示名称。
  • 可用 claude --model <模型ID>排除已保存模型选择的影响。
  • 自定义网关只保证其声明支持的接口；部分 Beta、文件上传或远程功能可能无法透传。

6. 官方参考