可可可AI 登录控制台

CLAUDE DESKTOP · GATEWAY · 约 6 分钟

Claude Desktop 配置教程

通过 Claude Desktop 的 Third-Party Inference 功能连接可可AI。只需配置 Gateway 地址、API Key 和认证方式。

开始配置 创建 API Key
  1. 01
    准备客户端安装 Claude Desktop 并创建 Key
  2. 02
    打开 Gateway从 Developer 菜单进入配置
  3. 03
    填写连接Base URL、密钥与认证方式
  4. 04
    测试重启测试连接并验证用量

安装客户端并创建密钥

CLAUDE DESKTOP

安装或更新客户端

安装后至少打开一次，确认应用菜单中可以看到 Developer。

下载 Claude Desktop
可可AI

创建 API Key

进入控制台“API 密钥”页面，创建或复制一枚可用密钥。

打开控制台
Gateway 根地址https://kekeshop.top
实际消息接口https://kekeshop.top/v1/messages

进入 Third-Party Inference

  1. 打开 Developer 菜单

    macOS 在顶部菜单栏操作；Windows 在应用菜单中操作。

  2. 选择 Configure Third-Party Inference...

    打开第三方推理配置窗口。

  3. Inference provider 选择 Gateway

    不要选择 Bedrock、Vertex 或 Foundry。

看不到 Developer？ 先更新 Claude Desktop，并在设置中检查 Developer 或 Advanced 相关选项，然后重启应用。

Gateway 参数

按下面的值填写。Base URL 使用根地址，不要直接填 /v1/messages。

Inference providerGateway
Gateway base URLhttps://kekeshop.top
Gateway API key填写可可AI控制台生成的 API Key
Gateway auth scheme优先选择 x-api-key；若界面没有该选项，可先使用默认值测试
Model discovery先开启自动发现；模型列表加载失败时再关闭并手动选择可用模型
为什么不填 /v1？ Claude Desktop 会在 Gateway 根地址后请求 /v1/messages，因此这里填写 https://kekeshop.top。

测试连接并验证

01

Test connection

先测试连接，成功后再保存配置。

02

完全退出应用

不要只关闭窗口，保存后完全退出 Claude Desktop。

03

发送一条消息

重新打开后发起对话，并检查控制台是否出现新增用量。

Claude Code CLI

使用 Claude Code 时，通过环境变量连接可可AI。

Terminal
curl -fsSL https://claude.ai/install.sh | bash
export ANTHROPIC_BASE_URL="https://kekeshop.top"
export ANTHROPIC_API_KEY="你的_API_Key"
claude
长期保存环境变量

将环境变量写入 ~/.claude/settings.json，保存后重新打开终端。

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kekeshop.top",
    "ANTHROPIC_API_KEY": "你的_API_Key",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

常见问题

Test connection 显示 401

重新复制完整 API Key，确认密钥可用，并将认证方式设为 x-api-key。

Test connection 显示 404

Base URL 应为 https://kekeshop.top，不要填入 /v1/messages。

模型列表加载失败

关闭自动发现，手动选择控制台当前支持的模型，再重新测试。

保存后仍使用原连接

完全退出 Claude Desktop 后重新打开；只关闭窗口可能不会重新加载配置。

控制台没有新增用量

检查 Provider、Base URL 与 API Key。没有新增记录通常表示请求未到达可可AI。

Claude Code 认证失败

优先使用 ANTHROPIC_API_KEY；Base URL 保持为根地址，不要加接口路径。