接入概览
在编程工具、Agent CLI 和业务客户端中接入 Modelink 时,你需要重点确认配置项、权限边界和使用方式。
核心配置
无论是 VS Code 插件生态、OpenCode、Claude Code、Codex、Hermes Agent、OpenClaw,还是业务客户端,通常都围绕三项配置展开:
| 配置项 | 说明 |
|---|---|
| Base URL | Modelink 接入点;中国大陆 https://api.qnaigc.com,海外 https://api.modelink.ai;OpenAI 兼容工具通常追加 /v1,Anthropic 兼容工具通常不带 /v1 |
| API Key | 在 Modelink 控制台获取,建议通过环境变量或本地安全配置传入 |
| Model ID | 工具或客户端实际调用的 Modelink 模型标识 |
编程工具配置入口
工具配置概览
查看自动配置、手动配置、配置文件位置和通用排障方式。
coding-helper 配置助手
使用交互式向导自动配置 Claude Code、Codex、CodeBuddy、WorkBuddy 和 Hermes Agent。
VS Code 自定义端点模型
通过 Language Models / Custom Endpoint 添加 Modelink 模型。
OpenCode 配置
使用自定义 OpenAI 兼容 provider 接入 Modelink。
Claude Code 配置
配置 Anthropic 兼容 Base URL 和认证 Token。
Claude Desktop 配置
说明 Claude Desktop 的限制、MCP 间接调用和桌面客户端替代方式。
Codex 配置
配置 OpenAI 兼容 provider、profile 和认证信息。
Hermes Agent 配置
通过自动配置或 custom provider 使用 Modelink。
OpenClaw 配置
在支持自定义 OpenAI 兼容 provider 的 Agent 工具中接入 Modelink。
其他编程工具
CodeBuddy、WorkBuddy、桌面客户端等工具的通用接入建议。
编程工具使用边界
编程工具可参与代码阅读、生成、重构、测试、审查和开发环境操作。接入时建议:
- 为个人、团队或项目配置独立 API Key,便于追踪用量和权限。
- 明确工具可读取和修改的仓库、目录和文件类型。
- 写入代码前展示变更摘要或 diff。
- 推送分支、创建 PR、发布版本、变更 CI/CD 前要求人工确认。
- 运行测试、类型检查或构建验证后再提交。
- 对高风险命令设置审批、沙箱或只读模式。
- 对
.env、密钥文件、生产配置、客户数据目录设置默认拒绝读取策略。 - 修改配置后完整重启工具,并使用工具内状态命令或配置检查命令确认 Base URL、API Key 和模型是否生效。
普通对话与 Agent 的区别
| 维度 | 普通对话 | Agent |
|---|---|---|
| 工作方式 | 被动回答问题 | 主动拆解并执行任务 |
| 能力范围 | 文本生成和理解为主 | 可调用工具、系统和数据源 |
| 任务复杂度 | 单步任务 | 多步骤、长流程任务 |
| 自主性 | 需要明确指令 | 可规划步骤并根据结果调整 |
| 治理要求 | 关注回答质量 | 额外关注权限、审计和人工接管 |
Agent 治理建议
Agent 一旦具备工具调用能力,就可能读取文件、访问网络、执行命令或触发业务动作。建议从只读、低风险能力开始,再逐步开放写入、外发、生产变更等高风险动作。上线前应明确工具权限、审计记录、人工接管和降级策略,具体生产治理可参考 生产最佳实践。
信息
工具接入建议先跑通低风险场景,再根据团队权限策略逐步扩大能力范围。