其他编程工具配置

除 VS Code 插件生态、OpenCode、Claude Code、Codex、Hermes Agent、OpenClaw 外，许多编程助手、桌面客户端和 Agent CLI 都支持 OpenAI 兼容服务。配置时通常填写 Base URL、API Key 和 Model ID。

CodeBuddy / WorkBuddy

推荐通过 qiniu-coding-helper 自动配置。

npx qiniu-coding-helper enter codebuddy
npx qiniu-coding-helper enter workbuddy

qiniu-coding-helper 官方仓库确认的当前管理路径如下：

工具	coding-helper 管理配置
CodeBuddy	`~/.codebuddy/models.json`
WorkBuddy	`~/.workbuddy/models.json`

这些路径表示自动配置工具会写入的文件，不代表所有版本都建议手动编辑。配置内容可能包含模型条目、API 地址、API Key 和能力标签；上述文件可能以明文保存 API Key，应按密码文件处理。

Hermes Agent

Hermes Agent 可使用 OpenAI-compatible custom provider，已整理为独立说明页。推荐参考 Hermes Agent 配置。

npx qiniu-coding-helper enter hermes

qiniu-coding-helper 当前会管理 ~/.hermes/config.yaml 中的模型相关字段。配置后应重启 Hermes Agent，并在会话或状态面板中确认当前模型和 provider 已切换到 Modelink。

Cherry Studio 等桌面客户端

支持自定义服务商的桌面客户端通常可按以下流程配置：

新建自定义服务商，命名为 Modelink。
填写 API Key。
OpenAI 兼容模式下填写接入点加 /v1，例如中国大陆 https://api.qnaigc.com/v1 或海外 https://api.modelink.ai/v1。
手动添加或选择目标模型 ID。
新建会话并切换到该模型，验证普通对话和流式输出。

如果客户端支持 Anthropic 兼容模式，Base URL 通常填写不带 /v1 的接入点，例如 https://api.qnaigc.com 或 https://api.modelink.ai，具体以该客户端配置项说明为准。

Cherry Studio 在添加服务商时需要按目标接口的协议选择服务商类型：

目标接口	服务商类型
`v1/chat/completions`	OpenAI
`v1/messages`、`bypass/anthropic/v1/messages`	Anthropic
`bypass/vertex/v1/models`	Gemini
`bypass/openai/v1/responses`	OpenAI-Responses

配置时，API 地址填入 https://api.modelink.ai（海外）或 https://api.qnaigc.com（中国大陆），API 密钥填入 API Key（多个密钥可用逗号分隔），再点击「添加」或「管理」配置需要使用的模型。注意最终访问接口务必与 API 地址下方显示的预览地址一致（例如选择 OpenAI-Responses 时预览地址应为 .../v1/responses）。

通用 OpenAI 兼容工具

如果某个工具支持自定义 OpenAI Base URL，可按以下方式填写：

配置项	建议值
Provider	自定义名称，例如 `Modelink`
Base URL	中国大陆 `https://api.qnaigc.com/v1`，海外 `https://api.modelink.ai/v1`
API Key	Modelink API Key
Model	目标模型 ID

通用排障

工具提示认证失败：检查 API Key 是否正确、是否混入空格或换行，并确认只配置了一个有效认证字段。
模型列表为空：确认工具是否支持手动模型 ID，或是否需要先拉取模型列表。
模型不可用：确认模型 ID 与 Modelink 控制台或模型广场展示一致，并检查当前账号是否具备调用权限。
请求路径错误：确认 Base URL 是否需要包含 /v1；OpenAI 兼容工具通常需要，Anthropic 兼容工具通常不需要。
流式输出异常：在工具中关闭/开启 streaming 后分别验证。
工具调用异常：确认所选模型和工具客户端均支持 tool calling。
配置修改无效：重启工具、重启终端，或检查是否存在覆盖配置的环境变量。