Claude Desktop 配置

Claude Desktop 主要面向 Claude 官方服务和本地 MCP 工具编排。它通常不提供把内置聊天模型直接切换到自定义 Modelink Base URL 的通用入口。因此，Claude Desktop 不能像 Claude Code 那样直接通过 ANTHROPIC_BASE_URL 接入 Modelink。

如果你的目标是在桌面端使用 Modelink，建议优先选择支持 OpenAI-compatible provider 的桌面客户端；如果目标是让 Claude Desktop 调用本地工具，可以通过 MCP 连接你的工具服务，再由该工具服务按业务需要调用 Modelink。

场景	建议方式
在桌面聊天客户端中使用 Modelink 模型	使用支持自定义 OpenAI Base URL 的客户端，例如 Cherry Studio 等
在 Claude Desktop 中使用本地工具	配置 MCP Server，由 MCP 工具内部调用 Modelink
在命令行 Agent 中使用 Modelink	使用 Claude Code、Codex、OpenCode、Hermes Agent 等可配置端点的工具

MCP 工具间接调用 Modelink

Claude Desktop 官方 MCP 文档说明，桌面端可以通过 Settings → Developer → Edit Config 配置 MCP Server。常见配置文件位置为：

系统	配置文件
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\\Claude\\claude_desktop_config.json`

MCP 配置用于声明本地工具服务，例如 mcpServers 下的 command 和 args；它不是模型 provider 配置。

如果你已经有一个 MCP Server，需要在工具内部调用 Modelink，可以让 MCP Server 读取环境变量：

export MODELINK_API_KEY="<your-api-key>"
export MODELINK_BASE_URL="https://api.qnaigc.com/v1"
export MODELINK_MODEL="<model-id>"

MCP Server 内部再按 OpenAI 兼容方式请求 Modelink。这样 Claude Desktop 负责工具编排，Modelink 负责模型能力，但两者之间不是“替换 Claude Desktop 内置模型”的关系。

桌面客户端替代方案

支持自定义 OpenAI 服务商的桌面客户端通常可以这样填写：

配置项	建议值
服务商名称	`Modelink`
Base URL	中国大陆 `https://api.qnaigc.com/v1`，海外 `https://api.modelink.ai/v1`
API Key	Modelink API Key
Model	控制台中的模型 ID

排障建议

如果 Claude Desktop 设置中没有 Base URL / Provider 配置项，说明不能直接替换内置模型服务。
如果使用 MCP 间接调用 Modelink，排查重点应放在 MCP Server 日志、环境变量和 Modelink 请求日志。
如果需要 Claude 风格命令行开发体验，优先参考 Claude Code 配置。

Claude Code 配置

使用 Anthropic 兼容接入点配置命令行开发工具。

其他编程工具

查看桌面客户端和 OpenAI 兼容工具的通用配置方式。

参考

MCP: Connect local servers