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.jsonWindows: 在文件资源管理器地址栏输入 %APPDATA%\Claude\ 即可打开对应目录。
环境变量方式
也可以通过设置环境变量来配置:
bash
export ANTHROPIC_BASE_URL="https://toprouter.cc"
export ANTHROPIC_API_KEY="your-api-key"然后重启 Claude Desktop。
验证配置
- 重启 Claude Desktop 应用
- 开始一个新对话
- 如果正常响应,说明配置成功
可用模型
通过 TopRouter 使用 Claude Desktop,您可以访问以下模型:
| 模型 | 说明 |
|---|---|
| Claude 4.8 Opus | 最强推理能力 |
| Claude 4.6 Sonnet | 推荐日常使用 |
| Claude 4.5 Haiku | 快速轻量 |
常见问题
配置后无法连接?
- 确认配置文件格式正确(有效的 JSON)
- 确认 API Key 正确且账户余额充足
- 完全退出并重启 Claude Desktop
- 检查网络连接是否正常
如何恢复默认设置?
删除或还原配置文件中添加的 apiBaseUrl 和 apiKey 字段,重启应用即可。
对话记录会丢失吗?
切换 API 代理不会影响本地保存的对话记录。
⚠️ 安全提示
配置文件中包含 API Key,请确保文件权限安全,避免被其他用户读取。
📖 相关文档
- Claude Code 接入 — 命令行工具配置
- API 密钥 — API Key 管理
