Claude Desktop：Cowork、Code 故障排查
解决 Claude 桌面端接入 BetterToken Gateway 后 Cowork 模式不可用、Code 模式提示 Claude Code process exited with code 1 的问题。
在 Claude 桌面端配置 BetterToken Gateway 后，如果出现以下现象，通常不是 API Key 本身不可用：
- Cowork 模式无法使用
- Code 模式提示
Claude Code process exited with code 1 - 同一套 API Key 在 Claude Code CLI 中可以正常使用
如果你还没有完成 Gateway 配置，请先参考 Claude 桌面端使用 BetterToken API。
先修复 Cowork 模式
Claude Desktop 仅支持 Claude 模型，这是 Claude Desktop 客户端的限制。
检查 API Key 是否复制完整、是否过期。此 Gateway 配置使用 x-api-key，保存后重启 Claude Desktop。
按照 Claude Desktop 接入文档配置 Gateway，Base URL 填写 https://bettertoken.ai，填入 BetterToken API Key，Gateway auth scheme 选择 x-api-key。点击 Apply locally 保存，然后完全重启 Claude Desktop。
再处理 Code 模式退出
如果 Cowork 恢复后，Code 模式（</> 标签页）仍提示 Claude Code process exited with code 1，重点检查 Claude 桌面端内置 Claude Code 是否还停留在旧版本。
根因：Claude 桌面端可能正在后台下载新版 Claude Code。下载完成前，Code 模式会回退到已安装的旧版 Claude Code。旧版可能不兼容第三方 Gateway 的 Code 模式，导致进程启动后立即退出。
解决方式：
等待新版 Claude Code 下载完成
保持 Claude 桌面端打开一段时间，让后台的 Claude Code 版本更新完成。
完全退出 Claude 桌面端
使用 Cmd+Q 完全退出应用，不只是关闭窗口。
重新打开并新建 Code session
重新打开 Claude 桌面端，再进入 Code 模式新建 session。
快速对照
| 现象 | 常见根因 | 解决方式 |
|---|---|---|
| Cowork | Gateway auth scheme | 检查 API Key 是否复制完整、是否过期。此 Gateway 配置使用 x-api-key，保存后重启 Claude Desktop。 |
Code 模式提示 Claude Code process exited with code 1 | 桌面端回退使用旧版 Claude Code | 等待新版下载完成，使用 Cmd+Q 完全退出后重新打开 |