GeiliAPI 接入手册

Claude Code

把 Claude 接到本站

本教程里说的 Claude,包括命令行里的 Claude Code,以及桌面上的 Claude Desktop。Claude Code 读用户级 settings.json。Desktop 在应用内配第三方网关,也可以交给 CC Switch;这两条桌面端路线都不读 Claude Code 的 settings.json。

开始前

先创建 Anthropic 分组 的密钥。Base URL 是 https://sub.geiliapi.com,不要再加 /v1。具体选哪个档位看控制台和 模型价格

先拿一把 Claude 分组密钥

创建时分组要选 Anthropic / Claude / CC 相关渠道,不要选 OpenAI 号池。名称可以叫 claude-office

创建密钥弹窗中的分组下拉,需选择 Claude 或 Anthropic 相关分组
你会看到:列表里既有 OpenAI 号池,也有「CC-反代渠道」「CC-满血MAX」这类 Claude 渠道。接到 Claude Code 时选后者,不要选 plus / Pro 号池。

完整步骤和复制 Key 的位置见 创建密钥

安装 Claude Code

官方推荐原生安装脚本。装完终端里应能跑 claude --version,输出带版本号和 (Claude Code)

macOS / Linux / WSL

Terminal
curl -fsSL https://claude.ai/install.sh | bash
claude --version

也可以用 Homebrew:brew install --cask claude-code。Homebrew 不会自动更新,之后要自己 brew upgrade claude-code

Windows PowerShell

PowerShell
irm https://claude.ai/install.ps1 | iex
claude --version

窗口标题或提示符带 PS 才是 PowerShell。若报 irm 不是内部命令,说明你在 CMD 里,应改用:

CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可以 winget install Anthropic.ClaudeCode。WinGet 不会自动更新,偶尔执行一次 winget upgrade Anthropic.ClaudeCode

提示

原生 Windows 建议同时安装 Git for Windows,这样 Claude Code 才能用 Bash 工具。没装的话它会退回 PowerShell。WSL 里不需要再装 Git for Windows。

安装命令如果报 syntax error near unexpected token '<'、403 或 curl 失败,先检查是否复制进了网页 HTML,或当前网络拦了 claude.ai

配置 Claude Code

推荐到 创建密钥 运行一键工具并选择 Claude Code。工具会备份后合并用户级 ~/.claude/settings.json,不会整文件覆盖。

手动配置时,打开(没有就新建)~/.claude/settings.json,把下面的 env 合并进去,不要删掉你已有的其他字段:

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://sub.geiliapi.com",
    "ANTHROPIC_AUTH_TOKEN": "替换为你的 Claude 分组 API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
  1. 1

    地址不要加 /v1

    写成 https://sub.geiliapi.com。多写 /v1 或自己拼 /v1/messages,最常见的结果是 404。

  2. 2

    变量名用 AUTH_TOKEN

    这里是 ANTHROPIC_AUTH_TOKEN,不是 OpenAI 那种只设 Authorization 的写法,也不是 ANTHROPIC_API_KEY 官方登录那一套。

  3. 3

    进项目目录再启动

    在要改的仓库里执行 claude。第一次会问是否信任该目录。不信任就读不到完整配置。

日常默认 claude-sonnet-5。最难的重构或长推理再切 claude-opus-4-8 / claude-opus-5。要更强写作或角色用 claude-fable-5。改模型后新建会话,并到控制台「使用记录」核对模型名。

Claude Desktop

先将 Claude Desktop 更新到支持第三方推理的最新版。单机使用时,Anthropic 官方推荐通过应用内窗口配置,不需要手工编辑 plist、注册表或 JSON。

  1. 1

    启用开发者模式

    macOS 从系统菜单栏进入 Help → Troubleshooting → Enable Developer Mode;Windows 从登录页左上角菜单进入同一路径。点完后按提示重启应用。

  2. 2

    打开第三方推理配置

    重新打开应用后,菜单里应多出 Developer。进入 Developer → Configure Third-Party Inference…。在 Connection 中把 Inference provider 设为 Gateway

  3. 3

    填写本站网关

    对照填写,不要凭记忆加路径:

    • Gateway base URL:https://sub.geiliapi.com
    • Gateway API key:Claude / Anthropic 分组 Key
    • Credential kind:Static API key
    • Gateway auth scheme:Bearer
  4. 4

    测试并应用

    先用窗口内的连接测试。通过后再点 Apply locally。应用会写入当前设备配置并重新启动。若模型没有自动发现,再按 Key 分组中的实际模型 ID 补充模型设置。

提示

不需要 CC Switch 也能直连。若你已经用 CC Switch 统一管理多个供应商,可继续使用其 Claude Desktop 页面;不要同时启用两套不同网关配置,以免排障时无法判断实际路由。

验证第一次请求

  1. 1

    跑一句最小任务

    完全退出 Claude Code 后重开,新建会话,发送:

    给 Claude
    只回复 OK。不要修改任何文件。
  2. 2

    核对使用记录

    到控制台「使用记录」确认出现这把 Anthropic 分组 Key 和实际模型 ID,而不是官方 api.anthropic.com。没有新记录,说明还在走官方登录态。

这个工具的故障

404 或提示找不到 messages

根地址多写了 /v1,或手工拼了完整 /v1/messages。改回 https://sub.geiliapi.com,让客户端自己拼接路径。对照见 地址怎么填

401 / 仍走官方

确认 Key 是 Anthropic 分组,环境变量是 ANTHROPIC_AUTH_TOKEN 不是 OpenAI 的 Bearer 配法。Desktop 不要和 CC Switch 同时启用两套网关。

换了模型但记录没变

旧会话会记住启动时的模型。完全退出后新建会话,再到「使用记录」核对。

PowerShell 和 CMD 互相报错

提示 && 不是合法分隔符,说明人在 PowerShell 里却贴了 CMD 命令。提示找不到 irm,说明人在 CMD 里却贴了 PowerShell 命令。

下一步:如果要同时切换多个供应商,看 CC Switch;只想换模型,看选模型页。

已复制