Claude Code 提供了 VS Code 扩展,让你在编辑器内直接与 Claude 交互编程。
前置条件
- 已 创建 API 令牌(选择 Claude 分组)
- 已安装 VS Code
安装扩展
- 打开 VS Code
- 进入扩展市场(macOS:
Cmd+Shift+X/ Windows:Ctrl+Shift+X) - 搜索 anthropic.claude-code
- 点击 安装
配置
Claude Code VS Code 扩展读取系统环境变量,配置方式与 CLI 相同。方式一:设置环境变量(推荐)
- macOS
- Windows
在终端执行:配置完成后需要完全退出并重新打开 VS Code。
macOS 用户如果从 Dock 启动 VS Code,可能读取不到环境变量。建议从终端执行
code 命令启动。方式二:通过 VS Code 设置
在插件页,点击设置图标,再点击设置,如下图
settings.json 中编辑,如下图

settings.json 中
使用
- 在 VS Code 侧边栏点击 Claude Code 图标
- 点击 +New seesion 开启新的对话窗口
- 在对话框中输入你的编程需求
- Claude 会直接在你的项目中读取和编辑代码

常见问题
提示 401 Unauthorized 或认证失败或卡着不动
提示 401 Unauthorized 或认证失败或卡着不动
macOS 从 Dock 启动 VS Code 后环境变量不生效
macOS 从 Dock 启动 VS Code 后环境变量不生效
macOS 从 Dock 或 Spotlight 启动的应用不会加载 shell 配置文件中的环境变量。解决方法:
- 从终端执行
code命令启动 VS Code - 或改用方式二,在 VS Code 的
settings.json中直接配置环境变量
环境变量和 settings.json 都配置了,以哪个为准?
环境变量和 settings.json 都配置了,以哪个为准?
如果两处都配置了,
settings.json 中的 claudeCode.environmentVariables 会覆盖系统环境变量。建议只保留一种配置方式,避免混淆。扩展安装后侧边栏没有 Claude Code 图标
扩展安装后侧边栏没有 Claude Code 图标
- 确认扩展已安装并启用(非禁用状态)
- 尝试重新加载窗口:
Ctrl+Shift+P(macOS 为Cmd+Shift+P)→Developer: Reload Window - 检查 VS Code 版本是否满足扩展的最低要求
扩展无响应或连接超时
扩展无响应或连接超时
- 确认网络可以正常访问
https://teio.me - 如果使用代理,在 VS Code 设置中检查
http.proxy是否正确配置 - 查看输出面板(
Ctrl+Shift+U)中 Claude Code 频道的错误日志
Windows 上设置环境变量后 VS Code 仍读取不到
Windows 上设置环境变量后 VS Code 仍读取不到
- 设置系统环境变量后必须完全关闭并重新打开 VS Code,仅重新加载窗口不够
- 如果问题持续,建议改用方式二,在
settings.json中直接配置