第 2 章：在 VS Code 里安装 Claude Code 扩展

我们直接通过 VS Code 的扩展市场安装 Claude Code，全程图形化操作，不需要敲命令。扩展会在第一次运行时自动准备好底层运行环境，你只管点击。

2.1 安装步骤

1. 打开 VS Code
2. 点击左侧活动栏中的 扩展图标（四个方块的那个，快捷键 Cmd+Shift+X / Ctrl+Shift+X）
3. 在搜索框输入 Claude Code
4. 找到由 Anthropic 发布的官方扩展（名称就是 "Claude Code"，发布者是 Anthropic，蓝色对勾的是认证账号）
5. 点击 Install

只装官方那一个

搜索结果里可能会出现多个"Claude xxx"的第三方插件。只安装 Anthropic 官方发布的那一个，其他第三方插件不在本指南范围内，可能存在数据安全问题。

2.2 第一次启动

安装完成后，VS Code 右下角会弹出"Claude Code 已就绪"或"Initialize Claude Code"之类的提示，左侧活动栏会多出一个 Claude Code 图标（彩色 C 字标）。

1. 点击这个图标，右侧会展开 Claude Code 对话面板
2. 第一次打开时面板会自动检查并下载所需的运行组件，等待绿色"Ready"提示出现即可
3. 底部会出现一个对话输入框

不用管"命令行"

和早期版本不同，现在 VS Code 扩展会自动管理底层运行所需的一切。你不需要单独打开终端、不需要敲安装命令——全部由扩展在后台完成。

2.3 验证扩展正常工作

在对话面板底部输入框里随便打一句话，比如：

你好，做一下自我介绍

如果看到"请先登录 / 配置 API Key"之类的提示，说明扩展本身已经就绪，只是还没认证——这个我们下一章解决。

如果对话面板完全没反应、按钮灰色、或者一直停在 "Initializing"，参考下方排查清单。

2.4 找不到图标 / 启动失败的排查

依次尝试：

现象	处理方式
活动栏没出现 Claude Code 图标	重启一次 VS Code
扩展页显示"已安装"但侧栏没图标	在扩展页找到 Claude Code，点齿轮图标 → "禁用" → 再"启用"
一直停在 "Initializing" / "Downloading"	检查网络。公司有内网代理的话联系 IT，参考第 3 章的代理配置
弹窗报"权限不足"或安装失败	Windows 用户：用管理员身份重新打开 VS Code 试一次

卡住超过 3 分钟就重启

扩展第一次启动需要联网下载组件。如果 3 分钟没动静，先把 VS Code 完全关掉重开。仍不行就联系 IT。

下一章：登录与配置 API Key →