Cherry Studio · 桌面端

Cherry Studio

Cherry Studio 把模型提供商作为服务来管理。把 NextModel 作为 OpenAI 兼容服务添加一次，它就会出现在你已有的服务列表旁边。

快速开始

  1. 获取你的 NextModel API 密钥

    在 NextModel 控制台创建密钥——桌面应用会把它保存在本地。

  2. 在设置 → 模型服务中添加提供商

    打开设置 → 模型服务，添加提供商，API 地址填 https://api.nextmodel.app/v1，密钥粘贴到 API 密钥。

    官方文档

  3. 在该提供商下添加 claude-sonnet-4-5

    使用提供商的添加模型功能，模型 ID 填 claude-sonnet-4-5，之后它会出现在对话的模型选择器里。

  4. 用一次请求验证

    在任意终端运行——返回 JSON 就说明地址、密钥和模型都对得上。

    Shell
    curl "https://api.nextmodel.app/v1/chat/completions" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "ping"}]}'

示例提示词

提示词保持英文以获最佳效果

提示词
Summarize this document and list the five most important action items.
Translate the selected paragraph into English and polish the tone for a release note.

常见问题

API 地址要包含 /v1 吗？

要。OpenAI 兼容服务的 API 地址填你的端点加 /v1——和 OpenAI SDK 期望的 base 一致。

密钥保存在哪里？

Cherry Studio 把提供商密钥保存在本地应用设置里，只会发送到你配置的 API 地址。

对话里看不到模型

自定义提供商的模型列表初始为空。先在该提供商下添加 claude-sonnet-4-5，再重新打开选择器。

故障排除

连接检查失败

确认 API 地址以 /v1 结尾且末尾没有多余的斜杠，再用第 4 步的 curl 验证密钥。

回复一直报 model not found

提供商下登记的模型 ID 必须与端点提供的一致——检查是否恰好是 claude-sonnet-4-5。

其他 Agent

CLIOpenAI

Codex CLI

OpenAI 的终端编程代理，指向 NextModel。

Codex CLI 从 ~/.codex/config.toml 读取模型提供商配置。添加一个指向 NextModel 端点的 provider 并导出密钥，之后每次 codex 调用都会经过 NextModel。

Codex CLI
IDEAnysphere

Cursor

AI 优先的 IDE，接上你自己的端点。

Cursor 支持为 OpenAI 兼容端点自带密钥（BYOK）。在 Settings → Models 中粘贴你的 NextModel 密钥，并把 OpenAI 提供商的 Base URL 指向 NextModel，OpenAI 格式的请求就会发往 NextModel。

Cursor
IDECline

Cline

VS Code 里的自主编程代理，用你自己的密钥。

Cline 是一个 VS Code 扩展，会在每一步征求你的确认后规划和修改代码。它的 OpenAI Compatible provider 接受任意端点，填一张表就能接上 NextModel。

Cline
SDKOpenAI

OpenAI SDK

任意 OpenAI SDK，只差一个 base_url。

官方 OpenAI SDK（Python 和 Node）都接受自定义端点。把 base_url 设为你的 NextModel 端点、密钥放在环境变量里，其余代码保持不变。

OpenAI SDK