主题
Claude Code Desktop
⚠️ 已知限制:无法绕过 OAuth 登录
Claude Code Desktop 强制 OAuth 登录,不支持通过环境变量或配置文件接入第三方中转。这是 Anthropic 官方的限制。
官方文档明确说明:
"Claude Desktop and remote sessions use OAuth exclusively and do not call apiKeyHelper or read API key environment variables." — GitHub Issue #57650
以下方式均无效:
- ❌
ANTHROPIC_API_KEY环境变量 - ❌
ANTHROPIC_BASE_URL环境变量 - ❌
~/.claude/settings.json的env块 - ❌
apiKeyHelper配置 - ❌
~/.claude/.credentials.json手动写入
目前没有可靠的绕过方式。
替代方案
方案一:CLI(推荐)
在终端使用 Claude Code CLI,功能与 Desktop 一致:
- 参见 Claude Code CLI 接入指南
- 配置环境变量后直接运行
claude
方案二:VS Code 终端
在 VS Code 内置终端中运行 CLI,可同时获得 IDE 集成体验:
- 参见 Claude Code VS Code 接入指南
- 在 VS Code 终端运行
claude
官方下载
如果你仍想安装 Desktop 以备后续官方支持,可以从以下地址下载:
bash
curl -fsSL https://claude.ai/install.sh | bashpowershell
irm https://claude.ai/install.ps1 | iex安装后需通过 Anthropic 官方账号 OAuth 登录,暂不支持 PudBot 中转。