Claude Code 桌面端

Claude 桌面应用里的 Code 选项卡。 和命令行版是同一个引擎，但独立的安装包、独立的配置入口。

先弄清它是什么

「Claude 桌面应用」有三个选项卡： Chat（对话）、Cowork（长任务与 Dispatch）、 Code（软件开发）。本页讲的是 Code 选项卡。

它和 Claude Code CLI 运行同一个底层引擎，只是套了图形界面。 两者可以装在同一台机器上、同时用，甚至操作同一个项目。

第一步：安装

从 claude.com/download 下载：

系统	说明
macOS	通用版本，Intel 与 Apple 芯片同一个包
Windows	x64；ARM64 另有安装程序
Linux（测试版）	通过 apt 或 .deb 安装

安装后启动 Claude，登录账号，然后点 Code 选项卡。

第二步：配置网关（关键，和 CLI 不一样）

方式一：官方入口 —— 第三方推理配置（先试这个）

1. 打开菜单 Help → Troubleshooting → Enable Developer Mode（勾选后应用会重启，菜单栏多出一个 Developer）。
2. 打开 Developer → Configure Third-Party Inference。
3. 填入网关地址（Base URL）：https://api.juheai.shop —— 不要加 /v1。
4. 保存，然后完全退出应用再重新打开。

如果贵公司/组织由管理员统一分发配置，这个表单会是只读的，说明已经配好、无需你自己填。
如果应用里找不到 Help 菜单或该菜单项（不同版本、不同系统会有差异），用下面的方式二。

方式二：本地环境编辑器（部分版本可用）

部分版本的桌面端支持给「本地会话」注入环境变量，这时可以和命令行版用同一套变量名：

1. 在提示框上打开环境下拉菜单
2. 把鼠标悬停在 Local 上
3. 点出现的齿轮图标，打开本地环境编辑器
4. 添加两个变量： ANTHROPIC_BASE_URL = https://api.juheai.shop
ANTHROPIC_AUTH_TOKEN = sk-你的密钥

在这里保存的变量会加密存储在你的机器上， 并适用于你启动的每个本地会话和预览服务器。

第三步：验证

在 Code 选项卡里新建一个会话，随便问一句。能正常回答就说明接通了。

没接通的话先看下面「排查」第一条 —— 桌面端配置不生效，九成是配置入口用错了（用了 CLI 那套）。

和命令行版的差异

项	命令行版	桌面端
配置入口	shell 环境变量 / .claude/settings.json	Developer → Configure Third-Party Inference（官方入口）
配置文件是否共享	是 —— ~/.claude.json、~/.claude/settings.json 两边通用
会话列表	各自独立；CLI 的会话可以带进桌面端
-p / --output-format	支持	不可用 —— 桌面端只能交互式使用
适合场景	脚本、远程服务器、终端习惯	图形操作、多会话并行、可视化 diff 审查

排查

配好了但桌面端还是连不上 / 一直要登录

• 最常见的原因：用了命令行版的配置方式。桌面端不读 ANTHROPIC_BASE_URL， 也不读 settings.json，要用 Developer → Configure Third-Party Inference 配（本页第二步）。
• 配完要完全退出应用再重新打开，光关窗口不算。
• 地址填 https://api.juheai.shop，不带 /v1。
• 提示 Gateway was unreachable 时，说明应用连不上这个地址：先在终端里确认能打开 https://api.juheai.shop（公司网络、代理软件可能拦），再检查地址有没有多打字符。

提示找不到 npm / node 等工具

官方建议：先在普通终端里确认这些命令可用，检查 shell 配置里的 PATH 是否正确，然后重启桌面应用让它重新加载环境变量。

Code 选项卡里 403 或认证错误

先确认密钥有效 —— 同一把密钥在命令行版里能通的话，问题在桌面端的变量送达， 而不是密钥本身。参见上面第一条。

官方文档：code.claude.com/docs/zh-CN/desktop （「来自 CLI？」「共享配置」「环境配置」几节）。 本页与命令行版的差异部分逐条对照该文档写成。