Skip to content

Claude 桌面版 ​

通过填写 Gateway 地址、API Key、Model ID,把 Claude 桌面 App 接到 AiCodeCat。

Claude 走 Anthropic 协议,Gateway base URL 填 https://aicode.cat,不要加 /v1。

先到 创建 API Key 拿一把 Key。模型名以 主站控制台 为准,点复制即可。

macOS / Linux ​

需要能访问外网下载 Claude App。Git 如未安装,macOS 可用 Homebrew:brew install git。

1. 下载 Claude App ​

打开 https://claude.com/download。若打开后先出现登录页,登录即可,再按下面配置。

2. 启用 Developer Mode ​

安装后打开 Claude App。点屏幕左上角 Help → Troubleshooting → Enable Developer Mode,弹窗选 Enable。

启用 Developer Mode

看不到 Developer 菜单?先彻底退出再重开

Developer 菜单要完全退出后重新打开才挂上。只关窗口、或从菜单栏图标把界面收起来都不算退出——Claude 还在后台跑,Enable Developer Mode 只是写进了配置,菜单得下次启动才出现。

  • macOS:点菜单栏图标 → Quit,或按 Cmd + Q。
  • Windows:右下角托盘图标右键 → 退出(点窗口的关闭按钮只是最小化到托盘)。

退出后重新打开 Claude App,左上角菜单里就有 Developer 了。

3. 打开第三方推理配置 ​

软件会重启。重启后点左上角 Developer → Configure Third-Party Inference。

4. 填写 Gateway 地址和 Key ​

页面初始只显示 Gateway base URL 和底部的 Credential kind(见下图),请先从底部开始选:

  1. Credential kind: 先在底部下拉选 Static API key(选完后页面上方会自动展开 Key 和鉴权方式输入框)
  2. Gateway base URL: 填 https://aicode.cat(不要加 /v1)
  3. Gateway API key: 填你在仪表盘创建的 Key
  4. Gateway auth scheme: 选 x-api-key
  5. 点 Test connection 测试连通性

先在底部选择 Static API key

展开后填写 Gateway 地址和 Key

5. 添加模型 ​

页面下滑到 Model list,点 Add。

点 Add 添加模型

Model ID 从控制台复制粘贴,例如:

文本
claude-opus-4-8
claude-opus-4-6
claude-sonnet-4-6
claude-haiku-4-5-20251001

Display name 用简写即可,例如 opus4.8。同一张卡片上还有:

  • Offer 1M-context variant:需要 100 万上下文时打开(只有上游真提供 1M 的模型才勾)
  • Tier alias:可留空;要钉到 opus / sonnet / haiku 档位再选

模型卡片字段

点 Apply Changes,提示时选 Save & Restart。

Apply Changes

Save & Restart

6. 测试 ​

重启后左下角是 Gateway,能正常回复即成功。失败先看 常见报错。

配置成功

7. 可选:把界面改成中文 ​

这步不影响接入,只把 Claude 桌面版的英文界面改成中文。用的是开源补丁 claude-desktop-zh-cn 1.4.16,会改本机 Claude 的资源文件,不改你的账号和 Key。

  1. 先退出 Claude 桌面版(不是最小化,要完全退出)。
  2. 下载压缩包:claude-desktop-zh-cn-1.4.16.zip。
  3. 解压到随便一个目录,打开解压出来的文件夹(里面应该能看到 README.md 和三个安装脚本)。
  4. 按你的系统双击对应的安装脚本,让它自动安装:

解压后按系统点对应的安装脚本

  • macOS:双击 install-mac.command。若提示无法打开,右键该文件 → 打开;仍被拦时到「系统设置 → 隐私与安全 → 仍然打开」里放行。
  • Linux(只支持官方 deb 安装的 Claude Desktop):在解压目录打开终端,执行:
Bash
chmod +x install-linux.sh
./install-linux.sh

AppImage、Flatpak、Snap 不能用这个脚本。

  1. 脚本出菜单后:
    • 选 1 安装中文补丁
    • 语言选 1 简体中文(繁体选 2 台湾或 3 香港)
    • macOS / Linux 会要你输入本机登录密码或 sudo 密码,输完回车
  2. 装完 Claude 一般会自动打开。如果还是英文:左下角账号菜单 → Language → 对应中文。

注意

官方更新 Claude 桌面版后中文可能被冲掉。再跑一次同一个安装脚本即可。要卸载补丁,也是跑脚本,菜单选 2 恢复原样。

Windows ​

Windows 10/11。Git 未装时到 Git 官网 下载,安装向导一路确认即可。

1. 下载并安装 Claude App ​

https://claude.com/download,装完会自动打开。若打开后先出现登录页,登录即可,再按下面配置。

下载或安装卡住(代理网络)

公司网络走代理时,安装包或在线组件可能拉不下来。在 PowerShell 里给当前窗口设上代理再重试安装:

PowerShell
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

把 7890 换成你本机代理端口。设完只对当前窗口有效,装完关掉即可,不用写进系统环境变量。

2. 启用 Developer Mode ​

点左上角三条杠,Help → Troubleshooting → Enable Developer Mode,选 Enable。

Windows 打开 Developer Mode

Enable 弹窗

看不到 Developer 菜单?要先退出托盘

Windows 上点关闭按钮只是最小化到托盘,Claude 并没有退出。右键任务栏右下角的 Claude 图标 → 退出,再重新打开,菜单才会出现 Developer。

3. 打开第三方推理配置 ​

重启后点三条杠,Developer → Configure Third-Party Inference。

Windows 打开第三方推理

4. 填写 Gateway 地址和 Key ​

与 macOS 相同,先在底部选 Static API key 展开表单,再回上方填写:

  1. Credential kind: 选 Static API key
  2. Gateway base URL: https://aicode.cat(不要加 /v1)
  3. Gateway API key: 仪表盘里的 Key
  4. Gateway auth scheme: 选 x-api-key
  5. 可先点 Test connection 测试连通性

先在底部选择 Static API key

展开后填写 Gateway 地址和 Key

5. 添加模型并测试 ​

Model ID 同样从控制台复制,例如 claude-opus-4-8、claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-20251001。需要 1M 上下文再打开 Offer 1M-context variant。

点 Apply locally(或 Apply Changes)后重启,发一句「回复 ok」能回即成功。

Windows 添加模型并 Apply locally

Windows 测试成功

6. 可选:把界面改成中文 ​

这步不影响接入,只把 Claude 桌面版的英文界面改成中文。用的是开源补丁 claude-desktop-zh-cn 1.4.16,会改本机 Claude 的资源文件,不改你的账号和 Key。

  1. 先退出 Claude 桌面版(不是最小化,任务栏右键图标 → 退出)。
  2. 下载压缩包:claude-desktop-zh-cn-1.4.16.zip。
  3. 解压到随便一个目录,打开解压出来的文件夹(里面应该能看到 README.md 和三个安装脚本)。
  4. 双击 install-windows.bat。若 Windows 拦下「Windows 已保护你的电脑」,点更多信息 → 仍然运行;接着 UAC 管理员授权点是。

解压后按系统点对应的安装脚本

  1. 脚本出菜单后:
    • 选 1 安装中文补丁
    • 语言选 1 简体中文(繁体选 2 台湾或 3 香港)
  2. 装完 Claude 一般会自动打开。如果还是英文:左下角账号菜单 → Language → 对应中文。

注意

官方更新 Claude 桌面版后中文可能被冲掉。再跑一次 install-windows.bat 即可。要卸载补丁,也是跑这个脚本,菜单选 2 恢复原样。

排错 ​

模型报 404 / model not found ​

桌面版把你填的 Model ID 原样发给网关,网关查不到就 404。按顺序查:

  1. Model ID 从 主站控制台 复制,不要手打,也不要把文档里的示例当通用名(claude-opus-4-8 只是举例)。
  2. 卡片上的 Model ID 要和 Key 所属分组里真实存在的 ID 完全一致,大小写、日期后缀都要对(例如 claude-haiku-4-5-20251001)。
  3. 上游改名或下线后,控制台里的新 ID 会和旧文档不同;以控制台为准,把卡片里的 ID 换成新的再 Apply。
  4. Tier alias 留空不影响模型映射;确实要按 opus / sonnet / haiku 档位自动映射时才填。
  5. 仍报 404:把 Model ID 和桌面版版本号记下来(不要带 Key),按 常见报错 逐条排除。

Code / Cowork 报虚拟化不可用(Windows) ​

桌面版里要跑本地沙箱的功能(Code、Cowork)依赖系统虚拟化,Windows 上要开两项:

  1. 按 Win + R 输入 optionalfeatures 回车,在列表里勾上 Virtual Machine Platform(虚拟机平台),确定后重启电脑。
  2. 重启时进 BIOS / UEFI 打开虚拟化:Intel 平台叫 Intel VT-x / Virtualization Technology,AMD 平台叫 SVM Mode(各主板位置不同,一般在 Advanced / CPU Configuration 里)。

两项都开好再启动 Code / Cowork;只开一项会继续报虚拟化不可用。