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. 检查网络连接是否正常

如何恢复默认设置?

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

对话记录会丢失吗?

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

⚠️ 安全提示

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

📖 相关文档

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