Claude Desktop · Third-Party Inference

Claude 中转站教程：Desktop 与 Claude Code 接入

面向「Claude 中转站 / Claude 中转」搜索用户：打开 Claude Desktop 顶部菜单 Developer，点击 Configure Third-Party Inference...，在 Gateway 配置里填写可可AI Claude 中转站地址和 API Key；也可用 Claude Code CLI。

开始配置 查看填写内容 Claude Code CLI 创建 API Key
ViewDeveloperWindowHelp
Open MCP Log File
Reload MCP Configuration
Configure Third-Party Inference...
Extensions
Open App Config File...
Open Developer Config File...
准备工作

先准备客户端和 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 菜单进入配置

重点按钮
1
打开 Developer 菜单

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

2
点击 Configure Third-Party Inference...

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

3
Inference provider 选择 Gateway

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

4
填写 Gateway credentials

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

5
点击 Test connection

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

6
完全退出并重启

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 配置。
相关搜索

Claude 中转站相关入口

如果你在找 Claude 中转站、Claude 中转、Claude Code 中转或 Claude API Key，可从下面入口继续。

Claude 中转站专页查看 Claude 中转站定位、公开分组与购买入口。 价格与余额充值日卡、月卡、按量余额与分组倍率说明。 Grok 中转站需要 Grok CLI / xAI 通道时跳转。
排查

常见错误处理

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 是否填入。