Skip to content

Claude Desktop 配置 ​

本指南介绍如何配置 Claude Desktop 桌面端通过 TopRouter API 使用 Claude 模型。

前置条件 ​

  • 已安装 Claude Desktop 应用
  • 已注册 TopRouter 账号并获取 API Key
  • 已完成 充值

配置方法 ​

修改配置文件 ​

Claude Desktop 的配置文件位于:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json

编辑配置文件,添加或修改 API 代理设置:

json
{
  "apiBaseUrl": "https://toprouter.cc",
  "apiKey": "your-api-key"
}

💡 如何打开配置文件

macOS:

bash
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

如果文件不存在,先创建它:

bash
mkdir -p ~/Library/Application\ Support/Claude/
echo '{}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: 在文件资源管理器地址栏输入 %APPDATA%\Claude\ 即可打开对应目录。

环境变量方式 ​

也可以通过设置环境变量来配置:

bash
export ANTHROPIC_BASE_URL="https://toprouter.cc"
export ANTHROPIC_API_KEY="your-api-key"

然后重启 Claude Desktop。

验证配置 ​

  1. 重启 Claude Desktop 应用
  2. 开始一个新对话
  3. 如果正常响应,说明配置成功

可用模型 ​

通过 TopRouter 使用 Claude Desktop,您可以访问以下模型:

模型说明
Claude 4.8 Opus最强推理能力
Claude 4.6 Sonnet推荐日常使用
Claude 4.5 Haiku快速轻量

常见问题 ​

配置后无法连接? ​

  1. 确认配置文件格式正确(有效的 JSON)
  2. 确认 API Key 正确且账户余额充足
  3. 完全退出并重启 Claude Desktop
  4. 检查网络连接是否正常

如何恢复默认设置? ​

删除或还原配置文件中添加的 apiBaseUrl 和 apiKey 字段,重启应用即可。

对话记录会丢失吗? ​

切换 API 代理不会影响本地保存的对话记录。

⚠️ 安全提示

配置文件中包含 API Key,请确保文件权限安全,避免被其他用户读取。

📖 相关文档

Unified AI API Gateway — Access 200+ models through one endpoint.