Claude Desktop · Third-Party Inference

Claude 桌面端配置可可AI中转站 URL

这份教程重点讲清楚截图里的按钮：打开 Claude Desktop 顶部菜单 Developer，点击 Configure Third-Party Inference...，在 Gateway 配置里填写可可AI中转站地址和 API Key。

开始配置查看填写内容 Claude Code CLI 创建 API Key

准备工作

先准备客户端和 API Key

约 2 分钟

1. 安装 Claude Desktop

先安装或更新 Claude Desktop。安装后至少打开一次客户端，确认顶部菜单栏能看到 Developer。

下载 Claude Desktop

2. 创建可可AI API Key

进入控制台的 API 密钥页面，创建或复制一枚可用 Key。购买套餐后系统也会自动生成 API Key。

3. 确认中转站地址

Claude Desktop 的 Gateway base URL 填可可AI根地址：https://kekeshop.top。客户端会请求 /v1/messages。

详细步骤

从 Developer 菜单进入配置

重点按钮

打开 Developer 菜单

在 macOS 顶部菜单栏或 Windows 应用菜单里找到 Developer。如果看不到 Developer，先升级 Claude Desktop，或在设置里开启开发者相关选项后重启。

点击 Configure Third-Party Inference...

这就是你截图里红框标出的按钮。它会打开第三方推理配置窗口，用来配置自建网关或中转站。

Inference provider 选择 Gateway

可可AI按 Anthropic Messages API 兼容方式提供中转，所以这里不要选 Bedrock、Vertex 或 Foundry，选择 Gateway。

填写 Gateway credentials

填写 Gateway base URL、Gateway API key 和 Gateway auth scheme。下面的“填写内容”区域可以直接照抄。

点击 Test connection

配置窗口里有测试连接按钮。先测试连接，成功后再保存或导出配置。

完全退出并重启

Claude Desktop 的第三方推理配置通常在启动时读取。保存后需要完全退出应用，再重新打开。

为什么不是填 https://kekeshop.top/v1？

Claude Desktop 的 Gateway base URL 是“网关根地址”。官方要求网关实现 POST /v1/messages，客户端会在根地址后请求这个路径。因此 Base URL 推荐填 https://kekeshop.top。如果某个客户端界面明确要求完整 API 前缀，再按界面提示使用 https://kekeshop.top/v1。

填写内容

Gateway 配置这样填

可直接复制

Connection / Gateway credentials

Inference providerGateway

Gateway base URLhttps://kekeshop.top

Gateway API key填写可可AI控制台生成的 API Key

Gateway auth scheme优先选择或填写 x-api-key。如果界面没有这个选项，留空使用默认 Bearer 后测试；测试失败再改为 x-api-key。

Model discovery可以先打开自动发现；如果模型列表加载失败，再关闭自动发现并手动填写控制台支持的模型名。

接口验证路径

如果需要用命令行验证连通性，请请求 /v1/messages，这也是 Claude Desktop 通过 Gateway 调用时需要的接口。

Base URL 填写
https://kekeshop.top

实际请求路径
https://kekeshop.top/v1/messages

认证头
x-api-key: 你的_API_Key

Claude Code CLI

命令行方式配置可可AI中转站

如果你用的是 Claude Code 终端工具，不需要打开桌面端配置窗口。安装 Claude Code 后，在终端里设置环境变量即可让请求走可可AI中转站。

CLI 方式

1. 安装 Claude Code

macOS、Linux、WSL 推荐使用官方安装脚本；Windows PowerShell 使用官方 PowerShell 安装脚本。

macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

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

检查安装
claude --version
claude doctor

2. 临时环境变量方式

适合先快速测试。把 你的_API_Key 换成可可AI控制台里的 API Key，然后在项目目录执行 claude。

macOS / Linux / WSL
export ANTHROPIC_BASE_URL=https://kekeshop.top
export ANTHROPIC_API_KEY=你的_API_Key
claude

Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://kekeshop.top"
$env:ANTHROPIC_API_KEY="你的_API_Key"
claude

3. 长期写入 settings.json

如果每次都要走可可AI，可以写入 Claude Code 用户配置。保存后重新打开终端，再运行 claude。

配置文件
~/.claude/settings.json

内容示例
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kekeshop.top",
    "ANTHROPIC_API_KEY": "你的_API_Key",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

4. 认证头选择

Claude Code 官方说明：设置 ANTHROPIC_API_KEY 时会按 x-api-key 发送；设置 ANTHROPIC_AUTH_TOKEN 时会按 Bearer Token 发送。可可AI优先推荐 ANTHROPIC_API_KEY。

推荐
ANTHROPIC_API_KEY=你的_API_Key

如果你的账号被要求 Bearer
ANTHROPIC_AUTH_TOKEN=你的_API_Key

CLI 里 Base URL 也填根地址

ANTHROPIC_BASE_URL 填 https://kekeshop.top。Claude Code 会在这个地址后请求 /v1/messages；不要把 /v1/messages 直接写进环境变量。

保存与导出

保存后要重启 Claude Desktop

容易漏

个人电脑

点 Test connection，确认连接成功。
按窗口提示保存配置，或导出后双击导入。
完全退出 Claude Desktop，不只是关闭窗口。
重新打开后发送一条消息，并到可可AI控制台看是否有新增用量。

团队或托管配置

macOS 可以导出 .mobileconfig。
Windows 可以导出 .reg。
导入后同样需要完全退出并重启 Claude Desktop。
如果本地配置和托管配置同时存在，托管配置通常优先生效。
需要终端方式的用户，可以直接看下面的 Claude Code CLI 配置。

排查

常见错误处理

Test connection 显示 401通常是 API Key 错误、Key 不可用、余额或套餐不可用。先重新复制控制台里的 Key，再确认 Gateway auth scheme 是否是 x-api-key。

Test connection 显示 404通常是 URL 路径填错。Gateway base URL 优先填 https://kekeshop.top，不要把 /v1/messages 填进 Base URL。

模型列表加载失败先不影响主连接测试。可以关闭模型自动发现，手动填写控制台支持的模型名，再重启客户端验证。

保存后还是走原来的 Claude确认已经完全退出应用并重启。配置通常只在启动时读取，只关闭窗口不一定生效。

看不到 Developer 菜单先更新 Claude Desktop，并在应用设置里找 Developer 或 Advanced 相关选项。开启后重启客户端再看顶部菜单。

控制台没有新增用量说明请求没有打到可可AI。重点检查 provider 是否选 Gateway、Base URL 是否为 https://kekeshop.top、API Key 是否填入。