ДокументацияНастройка клиентов手动配置 Claude Code

手动配置 Claude Code

不使用 CC Switch，通过 Claude Code 配置文件将其永久接入 SoleAPI。

手动配置 Claude Code

本页通过 Claude Code 的 settings.json 配置文件将其永久接入 SoleAPI。开始前，请先在控制台创建一个 API Key。

本页介绍的配置方式仅适用于 Claude Code，不适用于 Claude Desktop。Claude Desktop 需要使用其他配置方式。

老手看这里

编辑~/.claude/settings.json，自行替换:

json2

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

新手步骤级教程

Windows: C:\Users\你的用户名\.claude
MacOS: /Users/你的用户名/.claude
Linux: /home/你的用户名/.claude

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

Linux/MacOS 终端用户可以使用 cd ~/.claude 命令，图形化用户请自行努力吧 :D。

确认配置文件存在

我们需要的配置文件名为 settings.json，如果文件不存在，请手动创建；如果文件已存在，可以复制一份备份当前状态，便于操作失误后恢复。

修改配置文件

写入配置文件内容：

json

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

ANTHROPIC_BASE_URL 末尾一定不要带有 /，且使用的是https://soleapi.com，不要用https://soleapi.com/v1！！

生效验证

保存文件后，完全退出并重新启动 Claude Code。然后发送一条消息，能正常收到回复即表示配置成功。

常见问题

请求路径出现 /v1/v1/messages：Base URL 多填写了 /v1，改为 https://soleapi.com。
修改后配置没有生效：确认保存的是 .claude/settings.json，然后完全退出并重新启动 Claude Code。
返回 401：检查 ANTHROPIC_AUTH_TOKEN 是否完整、是否已停用。