vscode - Claude Code
在 VS Code 中使用 Claude Code 的核心步骤主要分为环境准备、安装插件和配置使用。根据你使用的API类型(官方服务或第三方平台),配置方式会有些不同。
下面是一套完整的配置流程。
1. 环境准备
首先,需要确保你的电脑上已经安装了必要的工具。
-
安装 Node.js:Claude Code 依赖于 Node.js 环境。在终端中运行
node -v检查是否已安装。如果未安装,需要先去 Node.js 官网 下载 LTS 版本 。 -
更新 VS Code:请确保你的 VS Code 版本不低于 1.98.0,否则可能无法安装插件。可以在“帮助” -> “关于”中查看版本号 。
2. 安装 Claude Code(二选一)
Claude Code 提供命令行(CLI)和图形界面(插件)两种使用方式,两者可以配合使用。
-
方式 A:安装 VS Code 插件(推荐)
这是直接在编辑器内使用的最方便的方式。-
打开 VS Code,进入扩展商店(快捷键
Ctrl+Shift+X)。 -
搜索 “Claude Code”。
-
找到后点击 “Install” 安装,安装完成后可能需要重新加载窗口 。
-
-
方式 B:安装命令行工具(可选)
如果你喜欢在终端操作,可以通过 NPM 全局安装。-
打开 VS Code 的终端(
Ctrl+`),运行以下命令:npm install -g @anthropic-ai/claude-code -
安装完成后,输入
claude --version验证是否成功 。
-
3. 核心配置(连接 API)
插件安装完成后,需要配置 API 才能使用。根据你有哪类 API 账号,选择对应的配置方式。
-
如果你有官方 API Key(最常用)
-
获取 Key:拥有 Anthropic 官方 API Key 后,点击 VS Code 侧边栏的 Claude Code 图标(Spark 图标)。
-
首次登录:插件会引导你打开浏览器进行登录授权,或者直接输入 API Key 。
-
验证:登录成功后,对话框即可正常使用。
-
-
如果你使用第三方代理(如星流、自定义代理)
如果你使用的是国内或第三方的 API 代理(通常是基于 DeepSeek 或其它中转服务),需要在 VS Code 设置中修改 API 地址。-
打开设置:按
Ctrl+,打开设置,搜索claude code。 -
找到环境变量:找到
Claude Code: Environment Variables选项,点击Edit in settings.json。 -
填入代理信息:在配置文件中添加或修改以下内容:
"claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value": "https://你的代理服务器地址" }, { "name": "ANTHROPIC_AUTH_TOKEN", "value": "你的API Key" } ]注意:具体的地址和 Key 需要向你购买的代理服务商获取 。
-
4. 启动与验证
配置完成后,就可以开始使用了。
-
启动方式:
-
点击 VS Code 右上角的 ⚡ 图标。
-
或者点击底部状态栏右下角的 ✱ Claude Code 图标 。
-
-
验证连接:
-
打开 Claude Code 对话框。
-
输入一个简单的测试指令,比如
Hello或者介绍一下这个项目。 -
如果能正常回复,说明配置成功 。
-
5. 核心使用技巧
为了让 Claude Code 更好地理解你的项目,这里有几个小技巧:
-
项目初始化:在终端中进入项目根目录,输入
claude回车,然后输入/init。Claude Code 会扫描项目并生成一个CLAUDE.md文件,这能帮助 AI 更好地理解项目上下文 。 -
@ 提及文件:在对话输入框中,输入
@符号可以快速引用当前打开的文件或特定代码段,让 AI 针对特定代码进行分析 。 -
权限控制:默认情况下,Claude Code 修改代码前会请求确认。如果你比较信任它并想提高效率,可以在终端使用命令
claude --dangerously-skip-permissions启动以跳过确认 。

浙公网安备 33010602011771号