从零安装 Claude Code 并接入 VS Code 技术文档

适用系统Windows1. 概述Claude Code是 Anthropic 推出的终端 AI 编程助手CLI 工具能在命令行中直接读写代码、执行命令、提交 Git并支持与 VS Code 深度集成。重要前提Claude Code 需要付费账号才能使用——Claude.ai 订阅Pro / Max / Team / Enterprise或API Key按量计费。免费的 claude.ai 账号不包含Claude Code务必先准备好其一。本教程覆盖环境要求 → 安装 → 登录认证 → 接入 VS Code → 常用命令 → 故障排查。2. 环境要求项目要求操作系统Windows 10 1809 / 1164 位不支持 32 位Node.js仅 npm 方式安装时需要18推荐 22 LTS。原生安装器无需 Nodeclaude code要靠它才可以跑起来Git2.38用于仓库分析必须要安装CC-Switch一键切换大模型APIvs code微软的免费编辑器Windows 特别说明过去官方推荐走 WSL2但2026 年起已原生支持 WindowsPowerShell / CMD 安装器 WinGet 包无需强制 WSL。追求更稳定体验仍可选用 WSL2。3. 安装 Claude Code3.1 安装node.js最好安装 Node.js 18推荐 22 LS。新版 npm 包可能提示迁移到原生安装器安装网址Node.js — 下载 Node.js®如果安装好后可以验证下具体步骤1.winr打开运行窗口2.输入cmd按Enter3.在窗口中输入 node -v 如果出现版本号即安装成功3.2 安装Claude code1.打开power shell用管理员方式打开npm install -g anthropic-ai/claude-code如果安装好后可以验证下具体步骤1.winr打开运行窗口2.输入cmd按Enter3.在窗口中输入 claude --version 如果出现版本号即安装成功3.3 : 进入Claude code1.直接在power shell运行窗口中输入claude并按Enter2.如出现下面情况则需要安装gitClaude Code on Windows requires git-bath3.4 git安装1.打开git下载网址Git - Install for Windows2.选择下面的安装命令安装位置随意但自己要知道在哪里3.安装好后重新打开power shell管理员身份运行4.输入claude4. 验证4.1 如果上述步骤都正确执行后会出先一个验证解决方法修改配置文件1.在我的电脑中输入你的用户名2.在下面找到claude.json3.打开并编辑4.添加配置项如下图在上一项后面加上逗号hasCompletedOnboarding: true,5.返回power shell窗口再次执行claude就可以进入。6.接着回车,届时会提示你去登录cloud账号但不推荐容易封号7.我们接入国产deepseek大模型4.2 安装CC-Switch1.打开Github2.打开下面网址 https://github.com/farion1231/cc-switch下拉找到Releases点击CC-Switch3.下拉找到适合我们系统的windows可以选择下面这个CC-Switch-v3.20.0-Windows.msi4.保存好后直接安装4.3 配置deepseek API1.打开deepseek2.选择API开放平台3.选择API keys4.创建API key(名字自己随意起最好是英文)5.创建好后复制APIKey密钥6.进入CC-Swtich里选择右上角的加号选择模型deepseek下滑将刚刚的APIkey填入进去然后添加添加好后。7.回到命令窗口输入claude就不会提示登录了我们输入/model,选择第一个就会出现deepseek的模型选择它并按回车8.选择好后和它对话你当前是什么模型回车4.4.到这里已成功安装Claude code5. 接入 VS Code5.1安装 VS CodeDownload Visual Studio Code - Free AI Code Editor for Mac, Linux, Windows安装好后5.2官方 VS Code 扩展官方扩展名为“Claude Code”发布者Anthropic市场 IDanthropic.claude-code已于 2026 年初 GA。安装步骤打开 VS Code → 扩展面板Ctrl/Cmd Shift X搜索“Claude Code”认准发布者 Anthropic 安装安装好后会在右上角出现一个橙色图标5.4接下来就可以使用Claude code 解决问题5.3 Windows 注意事项扩展与 CLI共享配置~/.claude/settings.json环境变量、hooks、MCP 服务器、允许的命令两者通用。只需 GUI 体验用扩展即可完整 CLI 能力MCP 配置、斜杠命令、!执行 bash在集成终端中使用。WSL 内登录用上文c复制认证链接的方式。6. 常用命令速查命令作用claude启动交互会话claude --version查看版本claude doctor健康检查 / 诊断claude update手动升级到最新版claude --ide自动连接可用 IDE/login/logout/status切换账号 / 退出 / 查看认证状态/ide管理 IDE 集成状态/help查看帮助7. 参考链接安装 / 配置官方文档https://code.claude.com/docs/en/setupVS Code 文档https://code.claude.com/docs/en/vs-codeIDE 集成https://code.claude.com/docs/en/ide-integrations快速上手https://code.claude.com/docs/en/getting-started官方扩展市场页Claude Code for VS Code - Visual Studio Marketplace