工具配置概览

你可以在 VS Code 插件生态、OpenCode、Claude Code、Codex、CodeBuddy、WorkBuddy、Hermes Agent、OpenClaw 等编程助手或 Agent CLI 中配置 Modelink，让这些工具使用 Modelink 大模型服务。

核心配置通常只有三类：

配置项	说明
Base URL	选择 Modelink 接入点：中国大陆 `https://api.qnaigc.com`，海外 `https://api.modelink.ai`
API Key	在 Modelink 控制台获取的访问密钥
Model ID	在工具中选择或填写要使用的模型 ID

由于 Modelink 提供主流协议兼容能力，大多数支持 OpenAI-compatible 或 Anthropic-compatible provider 的工具，只需要替换 Base URL、API Key 和 Model ID，即可复用原有工作流。OpenAI 兼容工具通常使用接入点加 /v1，Anthropic 兼容工具通常使用不带 /v1 的接入点。

警告

API Key 属于敏感凭证。不要写入仓库、截图、日志或公开工单；本地配置文件如果保存密钥，应按密码文件处理。

推荐方式：自动配置

推荐使用 qiniu-coding-helper 自动完成配置。它会通过交互式向导选择语言、线路、API Key、目标工具和模型，并写入对应工具的配置文件。完整说明见 qiniu-coding-helper 配置助手。

npx qiniu-coding-helper

配置流程：

选择语言。
选择线路，例如中国大陆 https://api.qnaigc.com 或海外 https://api.modelink.ai。
输入并验证 API Key。
选择要配置的编程工具。
选择模型。
重启对应工具，使配置生效。

支持自动配置的工具

以下路径来自 qiniu-coding-helper 官方仓库，表示该工具当前会管理或写入的本地配置位置；它们不是所有第三方工具的通用手动配置模板。

工具	类型	coding-helper 管理配置
Claude Code	CLI	`~/.claude/settings.json`、`~/.claude.json`
Codex	CLI	`~/.codex/config.toml`、`~/.codex/auth.json`
CodeBuddy	CLI	`~/.codebuddy/models.json`
WorkBuddy	桌面应用	`~/.workbuddy/models.json`
Hermes Agent	CLI	`~/.hermes/config.yaml`

VS Code 插件、OpenCode、Claude Desktop、OpenClaw 和其他客户端是否能直接接入，取决于工具是否支持自定义 OpenAI-compatible 或 Anthropic-compatible provider。GitHub Copilot 官方插件和 Claude Desktop 内置聊天通常不能直接替换为 Modelink 模型服务。

常用命令：

# 重新运行初始化向导
npx qiniu-coding-helper init

# 管理 API Key
npx qiniu-coding-helper auth

# 检查配置、网络、API Key 和工具安装状态
npx qiniu-coding-helper doctor

# 重新写入某个工具配置
npx qiniu-coding-helper auth reload codex

手动配置方式

如果目标工具暂未被自动配置工具覆盖，可以按该工具的配置格式手动填写 Modelink 接入点、API Key 和模型 ID。

qiniu-coding-helper

通过交互式向导自动写入已支持工具的本地配置。

VS Code 自定义端点模型

通过 Language Models / Custom Endpoint 添加 Modelink 模型。

OpenCode

使用 OpenAI 兼容 provider 配置 Modelink 接入点和模型。

Claude Code

通过环境变量或 settings 配置 Anthropic 兼容接入点。

Claude Desktop

了解 Claude Desktop 限制、MCP 间接调用和桌面客户端替代方式。

Codex

配置 OpenAI 兼容 provider、profile 和认证信息。

Hermes Agent

配置 Hermes Agent 的 custom provider 和默认模型。

OpenClaw

在 Agent 工具中配置自定义 OpenAI 兼容 provider。

其他编程工具

CodeBuddy、WorkBuddy、桌面客户端等工具的通用接入建议。

排障建议

确认 Base URL 是否选择正确区域；OpenAI 兼容工具通常使用带 /v1 的地址，Anthropic 兼容工具通常使用不带 /v1 的地址。
确认 API Key 未过期、未复制空格或换行，并且只在工具要求的一个认证字段中配置。
确认工具使用的模型 ID 与 Modelink 控制台或模型广场展示一致。
修改配置后完全重启工具；环境变量配置还需要重新加载 shell 配置或重启终端。
如果工具显示模型不可用，先用默认可用模型验证链路，再切换目标模型。
如果工具提示权限不足，检查工具自身的 allow / deny 配置以及当前项目目录授权。
优先运行 npx qiniu-coding-helper doctor 检查环境。