Claude Desktop

Anthropic 官方桌面应用(macOS / Windows)。默认走 Anthropic OAuth 登录,不直接暴露自定义 endpoint 设置,但下面三种方式之一都能接 Miloapi。

如果你主要是写代码 / agent 任务,更推荐 Claude Code CLI — 原生支持自定义 endpoint,接入最稳。

1. 下载安装

下载地址:https://claude.ai/download

装完会在应用程序 / 开始菜单出现 Claude 图标。

2. 三种接入方式

下面三种方式都讲一遍,任选其一即可。

3. 方式 ① Developer Settings / Use API Key

Claude Desktop 较新版本在「Settings」里提供了 Developer 面板,允许填入 API Key 跳过 OAuth 登录、且可指定 base URL。

3.1 进入 Developer 面板

如果左侧没有 Developer 入口,先勾选「Enable Developer Mode」(通常在 Settings → Help 或 About 里),保存后重启再回 Settings 就会看到。

⚠️ Developer 面板的入口和具体字段名随版本变化。下面字段名以最新稳定版为准,如果你的版本对不上,以应用内实际显示为准,或者改走方式 ② / ③。

3.2 配置 endpoint

在 Developer 面板里找到 API endpoint / Custom API 这一组,填:

保存后完全退出 Claude Desktop 再重启(只关窗口不算,详见 §7)。

⚠️ base URL 不带 /v1 — Claude Desktop 调的是 Anthropic 协议(跟 Claude Code CLI 一样),不是 OpenAI 协议。

⚠️ Key 选 Claude-MAX 池(platform=anthropic)。GPT / Gemini 池的 Key 调 Claude 模型会返回 404。

4. 方式 ② 手改 claude_desktop_config.json

如果 Developer 面板入口找不到,或者你想用脚本批量改,可以直接编辑配置文件。

4.1 文件位置

如果父目录 / 文件不存在,手动创建。macOS 下:

mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:APPDATA\Claude" | Out-Null
New-Item -ItemType File -Force "$env:APPDATA\Claude\claude_desktop_config.json" | Out-Null

4.2 写入配置

先完全退出 Claude Desktop(macOS:菜单栏 Claude → Quit;Windows:任务栏右键 Claude 图标 → Quit),然后写入:

{
  "mcpServers": {},
  "claude_api": {
    "base_url": "https://www.miloapi.com",
    "auth_token": "sk-你的key"
  }
}

保存后重新启动 Claude Desktop。

4.3 注意事项

• claude_api 不是官方文档列出的字段,Anthropic 没承诺向后兼容,升级 Claude Desktop 后有概率被重置。如果重置就重新写一遍,或者改用 ① / ③。
• mcpServers: {} 哪怕没有 MCP 也建议保留(空对象即可),避免 JSON 结构异常。
• 配置生效必须完全退出再重启,只关窗口不算。

5. 方式 ③ CC-Switch 统一切换

CC-Switch 是社区维护的 endpoint 管理工具,会同时维护:

• ~/.claude/settings.json(Claude Code CLI)
• claude_desktop_config.json(Claude Desktop)

切一次,CLI + Desktop 一起切。适合同时挂多个中转 + 官方账号的场景。

5.1 安装并添加 Miloapi

npm install -g cc-switch

cc-switch add miloapi-claude \
  --base-url https://www.miloapi.com \
  --token sk-你的key

也可以加多个配置(GPT 池 / 官方 / 其它中转),详见 CC-Switch 文档。

5.2 切到 Miloapi

cc-switch use miloapi-claude

CC-Switch 会同时写入 CLI 的 settings.json 和 Desktop 的 claude_desktop_config.json。

然后完全退出再重启 Claude Desktop — CLI 那边不用重启,新开 terminal 即可。

5.3 切换 / 查看

cc-switch list      # 看所有配置
cc-switch status    # 当前用的哪个
cc-switch use 官方  # 切回官方账号(撤销自定义 endpoint)

6. 验证

打开 Claude Desktop,输入框敲:

帮我用 Python 写一个快速排序,然后解释一遍逻辑

能流式输出代码 + 多轮追问正常,就算成功。

更可靠的验证 — 打开 Miloapi 控制台 → 使用记录,如果看到来自 Claude Desktop 的调用记录,说明确实走通了网关。

💡 让模型自我报告「现在连的是哪家 API」不靠谱 — 模型并不知道自己运行在什么 base URL 后面,可能会瞎回答。以控制台日志为准。

7. 故障排查

8. 跟 Claude Code CLI 的对比

⚠️ 如果你以写代码、跑 agent 任务为主,强烈推荐 Claude Code CLI — 接入更稳定,能力更完整,升级也不会丢配置。