AI 编程工具接入 MonkeyAI 的标准配置指南。

先验证 API Key 与 Base URL 是否可用

任何客户端配置前，先用下面命令确认 Key 和模型是通的。这里不需要安装客户端。

curl https://monkeytheme.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

能返回模型列表或鉴权通过，说明 Key 可用；如果返回 401，优先检查 Key 是否复制完整。

Cherry Studio

Cherry Studio 支持 OpenAI Compatible，是普通用户最容易配置成功的客户端之一。

1. 打开 Cherry Studio，进入左下角「设置」。
2. 进入「模型服务商」，选择「OpenAI Compatible / OpenAI 兼容」。如果没有，就点「添加服务商」。
3. 服务商名称填 MonkeyAI。
4. API Base URL 填 https://monkeytheme.com/v1。
5. API Key 填后台生成的 sk-...。
6. 手动添加模型名，例如 gpt-4o-mini、claude-sonnet-4-20250514-20250514。
7. 点击「检查」或新建对话测试。

Chatbox

Chatbox 也适合接 OpenAI-compatible 中转。

1. 打开 Chatbox，进入「设置 / Model Provider」。
2. 选择 OpenAI，或选择 Custom Provider / OpenAI Compatible。
3. API Host / Base URL 填 https://monkeytheme.com/v1。
4. API Key 填后台生成的 sk-...。
5. 模型名必须使用后台实际可见的完整名称。
6. 保存后发一句 hi 测试。

如果 Chatbox 版本只显示「API Host」而不是 Base URL，填同一个地址即可。

Cline

Cline 是 VS Code 里的 AI 编程 Agent。接入 MonkeyAI 时应选择 OpenAI Compatible 模式，而不是 Anthropic 或 Google 原生协议。

1. VS Code 扩展市场搜索并安装 Cline。
2. 打开左侧 Cline 面板，点右上角齿轮。
3. API Provider 选择 OpenAI Compatible。
4. Base URL 填 https://monkeytheme.com/v1。
5. API Key 填 sk-...。
6. Model ID 填 gpt-4o-mini 或你后台可见的模型。
7. 保存后让它读取一个小文件测试。

Provider: OpenAI Compatible
Base URL: https://monkeytheme.com/v1
API Key: sk-你的APIKey
Model ID: gpt-4o-mini

Roo Code

Roo Code（原 Roo Cline）配置方式和 Cline 类似，重点也是选 OpenAI Compatible。

1. VS Code 扩展市场安装 Roo Code。
2. 打开 Roo Code 面板，进入模型/API 设置。
3. 新增一个配置，名称可写 MonkeyAI。
4. API Provider 选择 OpenAI Compatible。
5. Base URL 填 https://monkeytheme.com/v1，API Key 填 sk-...。
6. Model 填真实模型名，保存。

Codex CLI

Codex CLI 应使用自定义 provider，并把 Key 放进 ~/.codex/.env，不要把密钥明文写进 config.toml。

macOS / Linux 一键配置

curl -fsSL https://monkeytheme.com/install/codex.sh | bash

Windows PowerShell

irm https://monkeytheme.com/install/codex.ps1 | iex

脚本会写入

~/.codex/config.toml
~/.codex/.env

完成后重新打开终端，运行 codex 或 codex exec "say hi" 测试。

Hermes

Hermes 支持自定义 OpenAI-compatible endpoint。建议先用脚本生成安全的环境片段，再按 Hermes 自己的 hermes model / hermes config 接入。

生成环境片段

curl -fsSL https://monkeytheme.com/install/hermes.sh | bash

irm https://monkeytheme.com/install/hermes.ps1 | iex

Claude Code

请勿将 MonkeyAI 的 OpenAI-compatible 地址直接填入 Claude Code 原生模式。Claude Code 原生接入通常需要 Anthropic 协议，例如 /messages。当前 MonkeyAI 公共入口是 /v1 OpenAI-compatible，不是 Anthropic 原生协议。

如果你要在编程工具里使用 Claude 模型，推荐用 Cline / Roo Code / Cherry Studio 的 OpenAI Compatible 模式，然后模型名选择 claude-sonnet-4-20250514-20250514 这类后台可见模型。

Claude Code 原生模式常见变量，仅供理解

ANTHROPIC_BASE_URL=需要支持 Anthropic /messages 协议的地址
ANTHROPIC_AUTH_TOKEN=你的Key
ANTHROPIC_MODEL=模型名

本站不提供容易造成误解的 Claude Code 原生直连脚本；如需使用 Claude 模型，建议优先选择支持 OpenAI-compatible 的客户端。

Gemini CLI

Gemini CLI 官方主线是 Google Gemini / Code Assist，不是通用 OpenAI-compatible 客户端。不同版本对自定义 endpoint 支持不稳定，所以不建议把它作为 MonkeyAI 的一键导入入口。

如果你想在 VS Code 里做 AI 编程，优先用 Cline 或 Roo Code；如果你想桌面聊天，优先用 Cherry Studio 或 Chatbox。

常见错误

1. Base URL 写成了 /v1/v1

客户端如果自动拼 /v1，你就只填域名；如果不会自动拼，就填完整 https://monkeytheme.com/v1。大多数 OpenAI Compatible 客户端需要填完整带 /v1 的地址。

2. Key 显示成 ***

这通常只是界面脱敏；但配置文件里不能真的写 ***。新版脚本已经修复这个问题。

3. 模型名不存在

请通过 /v1/models 或后台价目表确认真实模型名，避免填写 gpt-4、claude 等泛称。

4. Windows 脚本乱码

新版 PowerShell 脚本已设置 UTF-8 输出，并使用 UTF-8 无 BOM 写配置文件。如果旧终端仍乱码，请用 Windows Terminal 或 PowerShell 7。

5. Claude Code 跑不通

这是协议问题，不是 Key 问题。Claude Code 原生模式要 Anthropic 协议；MonkeyAI 当前客户入口是 OpenAI-compatible。