一、安装
1.1 安装vs code(使用cursor也可以)
安装略过;
为啥在vs code里去安装claude code呢?
- 使用起来简单:原生的claude code是命令行的,但对于刚接触的人来说,使用vs code的claude code插件了比较简单;
- 可以使用vs code的其他插件;
1.2 安装claude code
1.2.1 安装node.js
https://nodejs.org/zh-cn/download
1.2.2 安装claude-code
安装好之后,在vs code的teminal终端执行如下命令:
Linux/macOS 的命令:
sudo npm install -g @anthropic-ai/claude-code
window命令:
npm install -g @anthropic-ai/claude-code
1.2.3 验证是否安装成功:
she'l'l
claude --version
1.2.4 使用claude:
she'l'l
claude
报错:

说明 Claude Code 已成功启动,但无法连接到 Anthropic 的 API 服务器。这通常是因为:
- ❌ 没有配置 API Key(最常见)
解决方式是使用国内的厂商提供的api,这里我们在【1.2.6 安装cc-swich】里一起解决。
先直接看【1.2.6 安装cc-swich】操作完成后的效果:

到这里我们claude code已经安装成功了。
1.2.5 安装vs code的claude code插件

1.2.6 安装cc-swich
安装文档:https://docs.packyapi.com/docs/ccswitch/
安装完成后,添加你要的模型:

在编辑配置你的供应商、apiKey等信息:

我的百炼模型:
1.3 安装git
装git,主要是安装bash环境。如果不需要配置,则不需要安装。
需要安装的场景:你需要用到git的时候,比如让他生成一个项目,初次提交到仓库。。。
安装后,需要把git的bash.exe设置到claude全局配置中。网上搜就行。
二、开始使用
先试用一下:

2.1 介绍一下plan mode

三、编程应用
我这边是让他开发一个简单的笔记应用,这里就不贴了。略
四、问题解决:
4.1 执行npm install -g @anthropic-ai/claude-code命令报错:

解决方法:设置腾讯云镜*:
shell
# 1. 设置腾讯云镜像源
npm config set registry https://mirrors.cloud.tencent.com/npm/
# 2. 强制清除缓存(非常重要,清除之前的错误记录)
npm cache clean --force
# 3. 再次尝试安装
npm install -g @anthropic-ai/claude-code
4.2 报错二: 无法加载文件 D:\Java_Soft\node-v20.11.0-win-x64\node_global\claude.ps1,因为在此系统上禁止运行脚本
claude : 无法加载文件 D:\Java_Soft\node-v20.11.0-win-x64\node_global\claude.ps1,因为在此系统上禁止运行脚本

原因:
这是 Windows PowerShell 的执行策略(Execution Policy)限制 导致的 ------ 默认情况下,Windows 不允许运行未签名的本地脚本(包括 npm 全局安装生成的
.ps1启动脚本)。
解决方式:
- 以管理员身份打开 PowerShell(右键 → "以管理员身份运行")
- 执行:
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- 输入
Y确认更改。 - 关闭并重新打开普通 PowerShell 窗口。
- 再次运行。

验证效果:

4.3 cmd命令行,打claude报错:...CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
报错内容:
Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win). If installed but not in PATH, set environment variable pointing to your bash.exe, similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
解决方法1(推荐):
在path里新增以下路径:

用这种方式,再安装vs code,就不会出现相同的报错。
解决方法2:
新增环境变量:CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
注:C:\Program Files\Git\bin\bash.exe根据实际情况填写
4.4 vs code如何跳过登录官网的动作
配置步骤
文件->首选项->设置->搜索git.path->点击编辑->找到电脑git安装目录,找到bin文件夹,把里面的 git.exe 文件的完整路径复制下来:


4.5 vs code安装了claude code插件后,可能会有以下报错
报错一:

报错二:

vscode报错:GitLens requires a newer version of Git (>= 2.7.2) than is currently installed (GNU bash, version 4.4.23(1)-release (x86_64-pc-msys) Copyright © 2016 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html This is free software; you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.). Please install a more recent version of Git.
上面两个错误有可能不会出现,反正出现了您就配置把:
配置步骤
文件->首选项->设置->搜索git.path->点击编辑->找到电脑git安装目录,找到bin文件夹,把里面的 git.exe 文件的完整路径复制下来:
