主题
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 菜单?先彻底退出再重开
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(见下图),请先从底部开始选:
- Credential kind: 先在底部下拉选 Static API key(选完后页面上方会自动展开 Key 和鉴权方式输入框)
- Gateway base URL: 填
https://aicode.cat(不要加/v1) - Gateway API key: 填你在仪表盘创建的 Key
- Gateway auth scheme: 选 x-api-key
- 点 Test connection 测试连通性


5. 添加模型
页面下滑到 Model list,点 Add。

Model ID 从控制台复制粘贴,例如:
文本
claude-opus-4-8
claude-opus-4-6
claude-sonnet-4-6
claude-haiku-4-5-20251001Display name 用简写即可,例如 opus4.8。同一张卡片上还有:
- Offer 1M-context variant:需要 100 万上下文时打开(只有上游真提供 1M 的模型才勾)
- Tier alias:可留空;要钉到 opus / sonnet / haiku 档位再选

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


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

7. 可选:把界面改成中文
这步不影响接入,只把 Claude 桌面版的英文界面改成中文。用的是开源补丁 claude-desktop-zh-cn 1.4.16,会改本机 Claude 的资源文件,不改你的账号和 Key。
- 先退出 Claude 桌面版(不是最小化,要完全退出)。
- 下载压缩包:claude-desktop-zh-cn-1.4.16.zip。
- 解压到随便一个目录,打开解压出来的文件夹(里面应该能看到
README.md和三个安装脚本)。 - 按你的系统双击对应的安装脚本,让它自动安装:

- macOS:双击
install-mac.command。若提示无法打开,右键该文件 → 打开;仍被拦时到「系统设置 → 隐私与安全 → 仍然打开」里放行。 - Linux(只支持官方 deb 安装的 Claude Desktop):在解压目录打开终端,执行:
Bash
chmod +x install-linux.sh
./install-linux.shAppImage、Flatpak、Snap 不能用这个脚本。
- 脚本出菜单后:
- 选
1安装中文补丁 - 语言选
1简体中文(繁体选 2 台湾或 3 香港) - macOS / Linux 会要你输入本机登录密码或 sudo 密码,输完回车
- 选
- 装完 Claude 一般会自动打开。如果还是英文:左下角账号菜单 → Language → 对应中文。
注意
官方更新 Claude 桌面版后中文可能被冲掉。再跑一次同一个安装脚本即可。要卸载补丁,也是跑脚本,菜单选 2 恢复原样。
以下是 Windows
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。


看不到 Developer 菜单?要先退出托盘
Windows 上点关闭按钮只是最小化到托盘,Claude 并没有退出。右键任务栏右下角的 Claude 图标 → 退出,再重新打开,菜单才会出现 Developer。
3. 打开第三方推理配置
重启后点三条杠,Developer → Configure Third-Party Inference。

4. 填写 Gateway 地址和 Key
与 macOS 相同,先在底部选 Static API key 展开表单,再回上方填写:
- Credential kind: 选 Static API key
- Gateway base URL:
https://aicode.cat(不要加/v1) - Gateway API key: 仪表盘里的 Key
- Gateway auth scheme: 选 x-api-key
- 可先点 Test connection 测试连通性


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」能回即成功。


6. 可选:把界面改成中文
这步不影响接入,只把 Claude 桌面版的英文界面改成中文。用的是开源补丁 claude-desktop-zh-cn 1.4.16,会改本机 Claude 的资源文件,不改你的账号和 Key。
- 先退出 Claude 桌面版(不是最小化,任务栏右键图标 → 退出)。
- 下载压缩包:claude-desktop-zh-cn-1.4.16.zip。
- 解压到随便一个目录,打开解压出来的文件夹(里面应该能看到
README.md和三个安装脚本)。 - 双击
install-windows.bat。若 Windows 拦下「Windows 已保护你的电脑」,点更多信息 → 仍然运行;接着 UAC 管理员授权点是。

- 脚本出菜单后:
- 选
1安装中文补丁 - 语言选
1简体中文(繁体选 2 台湾或 3 香港)
- 选
- 装完 Claude 一般会自动打开。如果还是英文:左下角账号菜单 → Language → 对应中文。
注意
官方更新 Claude 桌面版后中文可能被冲掉。再跑一次 install-windows.bat 即可。要卸载补丁,也是跑这个脚本,菜单选 2 恢复原样。
排错
模型报 404 / model not found
桌面版把你填的 Model ID 原样发给网关,网关查不到就 404。按顺序查:
- Model ID 从 主站控制台 复制,不要手打,也不要把文档里的示例当通用名(
claude-opus-4-8只是举例)。 - 卡片上的 Model ID 要和 Key 所属分组里真实存在的 ID 完全一致,大小写、日期后缀都要对(例如
claude-haiku-4-5-20251001)。 - 上游改名或下线后,控制台里的新 ID 会和旧文档不同;以控制台为准,把卡片里的 ID 换成新的再 Apply。
- Tier alias 留空不影响模型映射;确实要按 opus / sonnet / haiku 档位自动映射时才填。
- 仍报 404:把 Model ID 和桌面版版本号记下来(不要带 Key),按 常见报错 逐条排除。
Code / Cowork 报虚拟化不可用(Windows)
桌面版里要跑本地沙箱的功能(Code、Cowork)依赖系统虚拟化,Windows 上要开两项:
- 按
Win + R输入optionalfeatures回车,在列表里勾上 Virtual Machine Platform(虚拟机平台),确定后重启电脑。 - 重启时进 BIOS / UEFI 打开虚拟化:Intel 平台叫 Intel VT-x / Virtualization Technology,AMD 平台叫 SVM Mode(各主板位置不同,一般在 Advanced / CPU Configuration 里)。
两项都开好再启动 Code / Cowork;只开一项会继续报虚拟化不可用。