Skip to content

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.jsonenv
  • apiKeyHelper 配置
  • ~/.claude/.credentials.json 手动写入

目前没有可靠的绕过方式。

替代方案

方案一:CLI(推荐)

在终端使用 Claude Code CLI,功能与 Desktop 一致:

  1. 参见 Claude Code CLI 接入指南
  2. 配置环境变量后直接运行 claude

方案二:VS Code 终端

在 VS Code 内置终端中运行 CLI,可同时获得 IDE 集成体验:

  1. 参见 Claude Code VS Code 接入指南
  2. 在 VS Code 终端运行 claude

官方下载

如果你仍想安装 Desktop 以备后续官方支持,可以从以下地址下载:

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex

安装后需通过 Anthropic 官方账号 OAuth 登录,暂不支持 PudBot 中转。