macOS Claude Desktop 桌面客户端对接中转站API完整教程

前置准备

软件：安装最新版 Claude Desktop（代码客户端，非网页版），macOS 13+ 支持

Homebrew 安装：brew install --cask claude-code

官网下载：https://claude.ai/download

中转站信息（自建网关/第三方中转通用）

Gateway Base URL：https://api.tok.mom（不要带 /v1 后缀，客户端自动拼接路径）

API Key：中转站tok.mom后台生成 sk- 开头密钥

要求：中转站兼容 Anthropic 协议

全程无需登录 Claude 官方账号，纯中转API调用

方法一：图形化可视化配置（推荐，新版自带，操作最简单）

步骤1：开启开发者模式

打开 Claude Desktop，弹出登录页直接忽略，顶部菜单栏点击 Help → Troubleshooting

选择 Enable Developer Mode，弹窗点击 Enable，App 自动重启

重启后顶部菜单栏新增 Developer 选项

步骤2：进入第三方API配置面板

点击顶部 Developer → Configure Third-Party Inference...

步骤3：填写中转站网关参数

Connection 选择 Gateway（Anthropic-compatible）

GATEWAY CREDENTIALS 填写核心参数：

Gateway base URL：你的中转地址，例：https://api.tok.mom

Gateway API key：中转站tok.mom复制的 sk-xxx 密钥

Gateway auth scheme：默认 bearer 无需修改

Gateway extra headers：无特殊鉴权留空；

步骤4：添加可用模型（模型列表空白必做）

切换到 IDENTITY & MODELS 标签页：

Model list 点击 + Add

Model ID 填入中转站支持的模型名称：
claude-3-5-sonnet-20240620、claude-opus-4-7、claude-3-haiku-20240307

开启 Offer IM context variant，多模型重复添加即可

步骤5：保存并重启客户端

右下角点击 Apply locally

弹窗选择 Relaunch now 重启 Claude

步骤6：切换中转模式使用

重启后首页出现两个选项：

Continue with Gateway：走你配置的中转API（选这个）

Sign in to Anthropic：官方账号直连
点击 Continue with Gateway，左下角模型下拉框选择刚才添加的模型，即可对话测试。

方法二：配置文件硬编码（无图形界面/旧版本备用）

1. 创建配置目录与文件

打开终端执行：

2. 写入中转配置模板

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tok.mom",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的中转站tok.mom密钥",
    "ANTHROPIC_MODEL": "claude-opus-4-7",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "alwaysThinkingEnabled": true
}

参数说明：

ANTHROPIC_BASE_URL： tok.mom域名，不带 /v1

ANTHROPIC_AUTH_TOKEN： tok.mom API密钥

ANTHROPIC_MODEL：默认调用模型

3. 保存生效

nano编辑器：按 Ctrl+O 保存 → 回车确认 → Ctrl+X 退出
完全退出 Claude 重新打开，自动读取配置走中转接口。

方法三：终端临时环境变量（单次生效，测试用）

仅当前终端打开的 Claude 生效，重启App失效：

TOK.MOM 中转站专属配置示例

图形化填写参数

Gateway base URL：https://api.tok.mom

Gateway API key：tok.mom后台创建的密钥

模型ID：claude-3-5-sonnet-20240620、claude-opus-4-7

settings.json 配置文件模板

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tok.mom",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7"
  }
}

常见报错与排坑

模型下拉框空白、无法选择模型
解决：在 Configure Third-Party Inference → IDENTITY & MODELS 手动添加对应 Model ID。

401 Unauthorized 鉴权失败

API Key复制有多余空格，重新完整复制密钥

Base URL填写错误，不要末尾加 /v1

请求超时/连接失败

确认中转站域名可正常访问，国内服务器无需魔法

若本地需要代理，在 env 中增加代理环境变量：

"HTTP_PROXY": "http://127.0.0.1:7890",
"HTTPS_PROXY": "http://127.0.0.1:7890"

找不到 Developer 菜单

更新 Claude Desktop 到最新版

完全退出App，重新执行 Enable Developer Mode

切换回官方账号
点击左下角头像 → Sign Out，重启后选择 Sign in to Anthropic 即可切回官方直连。

安全提示

API密钥不要泄露，避免他人盗用额度。

仅使用兼容 Anthropic 协议的中转，OpenAI格式中转无法直接对接本客户端。

Claude App（macOS 桌面客户端）配置接口AI大模型API (新版)

macOS Claude Desktop 桌面客户端对接中转站API完整教程#

前置准备#

方法一：图形化可视化配置（推荐，新版自带，操作最简单）#

步骤1：开启开发者模式#

步骤2：进入第三方API配置面板#

步骤3：填写中转站网关参数#

步骤4：添加可用模型（模型列表空白必做）#

步骤5：保存并重启客户端#

步骤6：切换中转模式使用#

方法二：配置文件硬编码（无图形界面/旧版本备用）#

1. 创建配置目录与文件#

2. 写入中转配置模板#

3. 保存生效#

方法三：终端临时环境变量（单次生效，测试用）#

TOK.MOM 中转站专属配置示例#

图形化填写参数#

settings.json 配置文件模板#

常见报错与排坑#

安全提示#