在 VSCode 中使用 Claude Code

本指南将帮助你在 Visual Studio Code 中安装和配置 Claude Code 插件，享受 AI 驱动的编程体验。

开始之前

请确保你已准备好：

已安装 Visual Studio Code
一个有效的 API 密钥

如果你还没有 API 密钥，请先前往密钥管理界面创建一个。

安装与配置步骤

安装 Claude Code 插件

打开 VSCode，点击左侧活动栏的扩展按钮（或按 Ctrl+Shift+X），在搜索框中输入 Claude Code，找到插件后点击安装。

在扩展市场搜索 Claude Code 并安装

打开插件设置菜单

安装完成后，在扩展列表中找到 Claude Code 插件，点击插件右侧的小齿轮图标。

点击插件的齿轮图标打开菜单

进入扩展设置

在弹出的下拉菜单中，点击「扩展设置」（Extension Settings）选项。

在下拉菜单中选择「扩展设置」

编辑 settings.json

在设置页面中，找到 Environment Variables 选项，勾选对应的复选框，然后点击「在 settings.json 中编辑」链接。

勾选复选框后点击「在 settings.json 中编辑」

配置环境变量

在打开的 settings.json 文件中，添加以下配置：

"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://yy.52ai.ai"
  },
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "你的API密钥"
  }
]

请将 你的API密钥 替换为你在密钥管理界面获取的真实 API 密钥（以 sk- 开头）。

配置完成后，效果如下图所示：

配置完成后的 claudeCode.environmentVariables 变量

保存并开始使用

保存 settings.json 文件（Ctrl+S）。配置完成后，你就可以在 VSCode 中使用 Claude Code 了！

你可以通过以下方式启动 Claude Code：

按下 Ctrl+Shift+P（Mac: Cmd+Shift+P）打开命令面板
输入 Claude Code 查看可用命令
或点击侧边栏的 Claude Code 图标

完整配置示例

以下是完整的 settings.json 配置示例：

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://yy.52ai.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  ]
}

如果你已有其他设置，只需将 claudeCode.environmentVariables 配置添加到现有的 JSON 对象中即可。

常见问题

插件无法连接？

请检查以下几点：

确保 ANTHROPIC_BASE_URL 设置为 https://yy.52ai.ai
确保 API 密钥正确无误，没有多余的空格
检查 Claude Code 内的环境变量是否被其他配置覆盖（在终端输入 /status 查看）
尝试重启 VSCode

如何更新 API 密钥？

直接编辑 settings.json 文件，修改 ANTHROPIC_AUTH_TOKEN 的值即可。

对话时提示需要 Git Bash？

Windows 用户如果在对话时出现报错提示需要 Git Bash，请下载安装 Git for Windows（安装时会自带 Git Bash）。

下一步

配置完成后，你可以探索更多功能：