Claude Code

本页介绍如何安装 Claude Code CLI，并通过 settings.json 配置文件将其永久接入 SoleAPI。若希望通过图形界面完成配置，也可以使用更便捷的 CC Switch。开始前，请先在控制台创建一个 API Key。

安装 Claude Code

这里展示通过 Node.js 附带的 npm 安装 Claude Code CLI。

1. 确认 Node.js 版本

当前 npm 版 Claude Code 要求 Node.js 版本不低于 v18(建议 >= v22 )。在终端中执行：

node -v

如果提示命令不存在或版本低于 v22，请前往 Node.js 下载页面安装或更新。

1. 使用 npm 安装 Claude Code

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

1. 验证安装

安装完成后执行：

claude --version

终端能够输出 Claude Code 版本号即表示安装成功。还可以运行 claude doctor 检查安装状态和配置文件。

配置接入 SoleAPI

1. 打开 Claude Code 配置目录

• Windows：C:\Users\你的用户名\.claude
• macOS：/Users/你的用户名/.claude
• Linux：/home/你的用户名/.claude

Windows 可通过 Win + R 打开「运行」窗口，输入 explorer %userprofile%\.claude，即可在资源管理器中打开对应目录。

Linux / macOS 终端用户可执行 cd ~/.claude 进入配置目录。

1. 确认配置文件存在

需要修改的文件名为 settings.json。如果文件不存在，请手动创建；如果文件已经存在，建议先复制一份备份。

1. 修改配置文件

将以下内容写入或合并到 settings.json，并将 sk-sole-你的Key 替换为自己的 API Key：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://soleapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-sole-你的Key"
  }
}

如果 settings.json 中已经存在其他设置，请保留原有字段，只在现有 JSON 结构中合并或修改 env。同名字段只能保留一份，并注意对象之间需要使用英文逗号分隔。

指定默认模型（可选）

如果需要为 Claude Code 的模型档位指定 SoleAPI 模型，可以在 env 中继续添加对应字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://soleapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-sole-你的Key",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "可选的模型 ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "可选的模型 ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "可选的模型 ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "可选的模型 ID",
    "CLAUDE_CODE_SUBAGENT_MODEL": "可选的模型 ID"
  }
}

模型 ID 请从模型广场复制，并确认当前 API Key 包含该模型所在的调度分组。若不需要固定模型，可以省略这些可选字段。

生效验证

保存 settings.json 后，完全退出并重新启动 Claude Code。在终端中执行：

claude

进入 Claude Code 后发送一条消息，能够正常收到回复即表示接入成功。如果已经打开 Claude Code，会话中的旧配置可能不会自动刷新，应退出后重新启动。

常见问题

• 请求路径出现 /v1/v1/messages：ANTHROPIC_BASE_URL 多填写了 /v1，改为 https://soleapi.com。
• 请求路径出现双斜杠：删除 ANTHROPIC_BASE_URL 末尾的 /。
• 修改后没有生效：确认文件名是 .claude/settings.json，JSON 格式正确，然后完全退出并重新启动 Claude Code。可运行 claude doctor 检查配置。
• 返回 401：检查 ANTHROPIC_AUTH_TOKEN 是否完整，以及 API Key 是否已停用或过期。
• 返回 403：检查 API Key 是否包含目标模型所在的调度分组；如果启用了 IP 白名单，请确认当前设备 IP 已加入白名单。
• 提示模型不存在或没有可用入口：检查模型 ID 是否与模型广场一致，并确认该模型在当前 API Key 的可用范围内。
• npm 提示权限不足：请检查 Node.js 和 npm 的安装方式与全局安装目录权限，不要直接修改 SoleAPI 配置文件来绕过安装错误。