使用文档 / Claude Desktop

Claude Desktop

通过 Windows 配置包，将官方 Claude Desktop 接入玄枢。获取配置包、填写自己的 API Key，再按步骤启用。

本页面针对 Windows 官方 Claude Desktop（第三方推理 / 3p 模式）。下文配置包已预设玄枢网关、九款 Claude 模型与 Opus 4.6 默认，API 留空，填入你自己的 Key 即可使用。

(一) 前置要求

已安装官方 Windows 版 Claude Desktop，并能正常启动。本页配置包用于接入与中文化，请先安装官方客户端。
在玄枢控制台创建自己的 API Key。
配置包及相关文件请加 QQ 群 1131848390 获取。

(二) 一键配置包能做什么

自动发现本机 Claude Desktop 安装，校验 Anthropic 官方签名与第三方推理能力。
在当前用户 %LOCALAPPDATA%\Claude-3p\configLibrary\ 写入第三方推理配置（不动官方 App）。
启用简体中文资源，默认 Opus 4.6，内置九款 Claude 模型。
写入前自动 DPAPI 加密备份原始配置，支持一键恢复；其它用户配置完整保留。
失败时主窗口显示具体错误与日志路径，不再统一提示“取消授权”。

(三) 使用步骤

从 QQ 群 1131848390 获取配置包 ZIP，完整解压到任意可读目录（不要在 ZIP 预览里直接运行）。
在解压后的文件夹中，用记事本打开 gateway-config.json，搜索 apiKey 字段：
```
"apiKey": "",
```
在两个英文双引号之间粘贴你自己的完整 API Key：
```
"apiKey": "在这里粘贴你自己的完整 Key",
```
保存文件，保留英文引号与逗号，其余字段先保持原样。
双击 一键配置.bat，按 Windows 提示允许同一账号的管理员授权（仅汉化需要，不会修改官方 EXE 签名）。
等待配置完成并自动打开 Claude Desktop，在 Chat 新建对话，发一条简单消息确认回复。

(四) 可用模型

本页对应已交付的 v1.0.2 配置包，使用包内固定的九款模型，默认 claude-opus-4-6（Opus 4.6）：claude-opus-4-6、claude-opus-4-7、claude-opus-4-8、claude-opus-5、claude-opus-5-5、claude-sonnet-5、claude-sonnet-5-5、claude-fable-5、claude-fable-5-1。新增模型需更新配置包中的模型清单并重新运行配置，本版仍按包内清单提供选择。修改默认模型时，编辑 gateway-config.json 的 defaultModel，保存后重新运行 一键配置.bat 并重启客户端。

(五) 常见问题

汉化未成功 / 管理员授权：按主窗口提示的日志目录查 result.json 与 upstream-transcript.log，手动按 Ctrl+C 复制错误行；日志位于 %LOCALAPPDATA%\Claude-Xuanshu-Setup\logs\patch-运行编号\。
Claude.exe 被占用：先从 Claude 菜单 File → Exit 或系统托盘“退出”正常关闭，不要强制终止其他用户的程序。
校验不一致：若提示核心文件被修改或备份含核心文件，一键流程会保留备份并明确停止，请先使用 Windows “修复”或重装官方 Claude，不要手动改 EXE 签名。
401 / invalid_api_key：Key 填错或已禁用，回控制台核对。

(六) 手动配置（可选）

手动接入需要使用当前官方客户端支持的第三方推理（3p）配置方式，设置 Anthropic 兼容地址 https://api.ai-trailblazer.com（不带 /v1）和自己的 API Key，并在应用配置后重新启动客户端。具体配置项与目录以当前版本的官方说明为准。首次接入可按本页一键配置步骤操作；通用地址与鉴权信息见手动配置。