ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

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

从零安装 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
返回列表