在 Windows 的 VSCode 上使用 Claude Code 的完整指南

这几天一直在弄claude code的相关操作,因为用的是windows版本,和wsl略有不同(wsl不方便连接IDE,不想把代码拷贝到wsl中),记录一下,当作一个经验贴了

cc-switch + claude + mcp router

一、 安装claude code

启动cmd

# 1. Node.js确保已安装(v18+)
node --version

# 2. 安装Claude Code
npm install -g @anthropic-ai/claude-code

# 3. 验证安装
claude --version

如果下载失败可以切换国内镜像试试
# 使用淘宝npm镜像
npm config set registry https://registry.npmmirror.com

# 临时使用镜像安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com


显示1.0.120 (Claude Code)版本号则安装完成

二、获取API_key

具体可以看我另一篇帖子 ----> [方便我开发的一些站]

1、 pro ai 或者univibe 或者 agent router

2、注册完成后 点击API令牌 然后点击添加API令牌
在这里插入图片描述

3、自用的话只需要把无限额度勾上即可
在这里插入图片描述

4、创建完成后点击密钥的复制即是用户密钥,等会要用
在这里插入图片描述

三、设置环境变量

可以使用CC-switch https://github.com/farion1231/cc-switch

下载后即可配置 将官网链接以及刚刚复制的apikey填入其中即可
在这里插入图片描述

编辑通用配置 ,只需要这两行即可,其他是功能配置

{
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
  "DISABLE_TELEMETRY": "1"
}

在这里插入图片描述
在这里插入图片描述

或者不用 CC-switch 自己更改环境变量

1、底部搜索 编辑系统环境变量
在这里插入图片描述
2、在系统变量中添加变量,添加完成后记得重启电脑 (下面还有添加bash系统环境变量的部分,可以翻到第五点一起操作)

变量名
ANTHROPIC_BASE_URL https://agentrouter.org/
ANTHROPIC_AUTH_TOKEN sk-xxxx(刚刚申请的密钥)
ANTHROPIC_API_KEY sk-xxxx(刚刚申请的密钥)

在这里插入图片描述

四、启动Claude

通过vscode 进入你的项目中 点击扩展 搜索Claude Code for VS Code 安装
在这里插入图片描述

装完之后你就可以看到在编辑器右上角有一个图标了(点击这个或者自己在终端里面输入claude效果一样)
在这里插入图片描述

一般会遇到这种问题

在这里插入图片描述
打开我的电脑,一般是这个目录下 C:\Users\你的用户名,找到 .claude.json
在这里插入图片描述
打开 加上一行代码

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "firstStartTime": "2025-07-14T06:11:03.877Z",
  "userID": "f5afdd05117c901a4a5a0761d08230bfcbb76f9fd380ff7bc144cc12c52e55aa",
  "projects": {
    "/home/nassi": {
      "allowedTools": [],
      "history": [],
      "mcpContextUris": [],
      "mcpServers": {},
      "enabledMcpjsonServers": [],
      "disabledMcpjsonServers": [],
      "hasTrustDialogAccepted": false,
      "projectOnboardingSeenCount": 0,
      "hasClaudeMdExternalIncludesApproved": false,
      "hasClaudeMdExternalIncludesWarningShown": false
    }
  },  //这里要加逗号,注意英文的
  "hasCompletedOnboarding": true  // 新增字段放在这里,注意位置
}

添加完成后就正常了,然后我们点击图标或者在终端中输入 claude

在这里插入图片描述
选YES
这里他每一步都会询问你要不要操作,如果你嫌烦 可以在终端输入,或者打开yolo模式(自行百度)

# 跳过权限确认(危险但高效)
claude --dangerously-skip-permissions

如果你按照之前的步骤一步一步做了,那么显示就如下,它会读取你的系统变量,让模型走API

在这里插入图片描述
【可选】 输入 /init ,claude会为你的项目创建cc说明
在这里插入图片描述
在这里插入图片描述

五、安装MCP

下载MCP-ROUTER

https://github.com/mcp-router/mcp-router
导入文章内容顶部的资源json后如图所示
在这里插入图片描述
然后再MCP应用集成里面找到claude,将第二点的代码复制到 “C:\Users\用户名.claude.json”
在这里插入图片描述
在这里插入图片描述

或者用claude自带的mcp下载

打开cmd终端(不是claude终端哈)
搜索 where git 找到git的目录进入
在这里插入图片描述
找到git目录下的bin下的bash.exe 复制路径
在这里插入图片描述

转到系统环境变量 添加至系统变量中 CLAUDE_CODE_GIT_BASH_PATH
在这里插入图片描述
然后转到 项目终端 从目录或者vscode进都可以
输入(仅供参考,需要什么mcp可以自己去搜索添加)

# context7
claude mcp add context7 -s user -- npx @upstash/context7-mcp@latest

# 文件检索
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects ~/Desktop

# deepwiki
claude mcp add deepwiki -s user -- npx mcp-remote https://mcp.deepwiki.com/mcp

#thinking
claude mcp add thinking -s user -- npx @modelcontextprotocol/server-sequential-thinking

#memory
claude mcp add memory -s user -- npx @modelcontextprotocol/server-memory

在这里插入图片描述
MCP添加完成后 进入Claude终端 输入/mcp
在这里插入图片描述
如果安装完成则会如下显示
在这里插入图片描述
filesystem这个mcp可能会连接失败,可以按照如下步骤
首先还是打开上面解决报错的json文件 C:\Users\qishisan.claude.json 找到filesystem
把这里的目录替换一下 换成双斜杠 上面
claude mcp add filesystem -s user – npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects ~/Desktop
中的~/Documents ~/Projects ~/Desktop 是指定的目录文件,意思是这个mcp可以从哪里读取文件以及照片信息,你可以设置为你的项目存放目录

在这里插入图片描述

六、连接IDE,开始agent编程!

上述工作全部做好后,重新打开vscode,进入claude终端
输入/ide
在这里插入图片描述

选择 vscode,完成
在这里插入图片描述
后面 要改哪里的代码 直接选中,终端就知道你选中的是哪几行了
在这里插入图片描述
也可以在设置中设置自动连接 输入/config

在这里插入图片描述
其他指令 就麻烦你们自己去看官方文档了,我就不一一介绍了,如果有什么问题可以评论区留言

不用wsl真爽 [doge]

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐