PudBot

主题

Claude Code VS Code ​

Claude Code VS Code 扩展是 Anthropic 官方推出的 VS Code 插件，提供 IDE 内集成的 AI 编程体验。

安装 ​

  1. 打开 VS Code，进入扩展商店
  2. 搜索 Claude Code 并安装
  3. 需 VS Code 1.98.0+

配置方式 ​

VS Code 扩展支持两种接入方式。

方式一：终端 CLI（推荐） ​

在 VS Code 内置终端（Ctrl+`）中直接使用 CLI 版 Claude Code，功能与扩展版一致：

  1. 安装 CLI：npm install -g @anthropic-ai/claude-code
  2. 配置环境变量（参见 Claude Code CLI）
  3. 在 VS Code 终端运行 claude

CLI 会自动识别当前工作目录，能读写 VS Code 打开的项目文件。

💡 推荐

这是最简单可靠的方式，无需修改任何 VS Code 配置。

方式二：写入凭证文件 ​

VS Code 扩展默认强制 OAuth 登录，不支持直接读取环境变量。可以通过手动写入凭证文件绕过：

步骤：

  1. 先在终端用 CLI 完成首次认证：
bash
export ANTHROPIC_BASE_URL=https://token.pudbot.com
export ANTHROPIC_API_KEY=*** Key
claude  # 发条消息确认能用，然后退出

  1. CLI 会在 ~/.claude/ 下生成凭证文件

  2. 重启 VS Code，打开 Claude Code 扩展

  3. 如果扩展读取到凭证文件，会跳过 OAuth 登录

⚠️ 稳定性提示

此方法依赖扩展读取 ~/.claude/.credentials.json 的行为，Anthropic 随时可能修改。如果无效，请使用方式一（终端 CLI）。

方式三：settings.json 配置 ​

在 VS Code 设置文件中配置环境变量：

按 Ctrl+Shift+P（macOS Cmd+Shift+P）→ 搜索 "Preferences: Open User Settings (JSON)"，添加：

json
{
  "terminal.integrated.env.windows": {
    "ANTHROPIC_BASE_URL": "https://token.pudbot.com",
    "ANTHROPIC_API_KEY": "sk-你的APIKey"
  }
}

macOS / Linux 用户：

json
{
  "terminal.integrated.env.osx": {
    "ANTHROPIC_BASE_URL": "https://token.pudbot.com",
    "ANTHROPIC_API_KEY": "sk-你的APIKey"
  }
}

配置后，VS Code 内置终端会自动继承这些环境变量。打开终端运行 claude 即可。

验证 ​

CLI 方式 ​

在 VS Code 终端运行：

bash
claude

发送消息，正常回复即配置成功。

扩展方式 ​

打开 VS Code 右侧 Claude Code 面板（Spark 图标），发送消息验证。

排障 ​

扩展提示 "必须登录" / "Invalid API key" ​

VS Code 扩展强制 OAuth 登录是 Anthropic 官方限制（Issue #10283）。解决方案：

  1. 首选：在 VS Code 终端直接用 CLI（方式一）
  2. 备选：手动写入凭证文件（方式二）

settings.json 环境变量不生效 ​

terminal.integrated.env 只对 VS Code 终端生效，不影响扩展本身。扩展面板仍需通过方式一或方式二接入。

登录循环 / 卡在 OAuth ​

  1. 删除 ~/.claude/.credentials.json（如存在）
  2. 确认环境变量已正确设置
  3. 使用终端 CLI 方式绕过 OAuth