Claude Code Windows使用指南

推荐优先下载

安装配置所需要的安装包网盘链接：（网盘被屏蔽，需要到下面链接下载）
推荐使用场景：如果因网络问题无法从官网下载，强烈推荐使用此工具包
包含
Git (版本控制基础) 必需 https://qfengs.lanzoum.com/iAtfJ39fkkib
Node.js (运行环境) 必需 https://nodejs.org/

一、Windows安装方法

(一) 安装Node.js环境

官网下载
1. 打开浏览器访问 https://nodejs.org/ 或浏览器搜索node.js中文网

2. 进入并下载（版本号要大于18，推荐长期支持版本）

3. 下载完成后双击 .msi 文件

4. 打开文件并安装，这一步要勾选其他不用管，一直下一步直到安装成功

Windows 注意事项

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node -v

如果显示版本号就是正确的
再输入

npm -v

再次出现版本号就说明安装成功！

5. 进行环境配置，打开node.js的文件位置，找到node.js然后右键打开文件所在位置

6. 进入这个页面新建node_cache的文件夹，再建node_global文件夹

7. 在桌面新建一个文档，把这两行命令放进去，地址改为刚刚新建两个文件的地址

8. 以管理员的身份打开命令提示符，把刚刚的两行命令粘贴进去

9. 检查是否配置成功，输入npm config get prefix，出现刚刚复制进去的地址就说明成功啦

10. 另一个一样，输入npm config get cache，出现地址说明成功

11. 再打开环境变量，系统变量里面新建变量名为NODE_PATH，变量值就把global地址放进去后面加上\node_modules，点击确定

12. 再到上面用户变量的path点击编辑，将最后一行改为global的地址，点击确定

13. 再次到下面的系统变量里面找到path点击新建：%NODE_PATH%，一直确定

14. 打开cmd，输入npm install express -g，出现这个页面说明安装成功了安装Node.js

二、安装git

方式一：

蓝奏云下载链接：https://qfengs.lanzoum.com/iAtfJ39fkkib
和nodejs安装步骤一样：安装一直点next即可

方式二：

1. 到git官网下载git，选择合适的版本

2. 下载完之后编辑环境变量，在系统变量里面新建，变量名为CLAUDE_CODE_GIT_BASH，变量值找到bash的位置，复制进来，一直确定

3. 安装完成后，打开 PowerShell 或 CMD，输入以下命令：

git -v

如果显示版本号，说明安装成功了！

安装 Claude Code

1. 打开powershell/cmd命令提示符，运行以下命令

npm install -g @anthropic-ai/claude-code

出现这个样子说明成功

2. 打开https://xh.v1api.cc 链接，进入到星火api页面，自己注册登录，点击左侧的令牌管理，找到初始令牌复制，里面有免费额度可以使用

3. 打开powershell终端输入以下命令

setx ANTHROPIC_API_KEY "sk-你的令牌"
setx ANTHROPIC_BASE_URL "https://xh.v1api.cc"

然后重启一下终端让他生效

4. 最后我们输入claude，就会出现这个页面，一直回车进去就可以使用了

5. 这里一直回车

Windows 安装常见问题解决

安装时提示 "permission denied" 错误
这通常是权限问题，尝试以下解决方法：

以管理员身份运行 PowerShell
或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误
如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

三、Mac/Linux 使用步骤

(一) 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

macOS 安装方法

方法一：使用 Homebrew（推荐）
如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

#更新 Homebrew
brew update
#安装 Node.js
brew install node

方法二：官网下载

访问 https://nodejs.org/
下载适合 macOS 的 LTS 版本
打开下载的 .pkg 文件
按照安装程序指引完成安装

macOS 注意事项

如果遇到权限问题，可能需要使用 sudo
首次运行可能需要在系统偏好设置中允许
建议使用 Terminal 或 iTerm2

验证安装是否成功
安装完成后，打开 Terminal，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

(二) 安装 Claude Code

安装 Claude Code
打开 Terminal，运行以下命令：

#全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果遇到权限问题，可以使用 sudo：

sudo npm install -g @anthropic-ai/claude-code

验证 Claude Code 安装
安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

(三) 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：
方法一：临时设置（当前会话）
在 Terminal 中运行以下命令：

export ANTHROPIC_BASE_URL="https://xh.v1api.cc"

export ANTHROPIC_API_KEY="你的API密钥"

bash <(curl -sSL https://xh.v1api.cc/run_claude_proxy.sh)

*注意：记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

echo $SHELL

输出 /bin/bash → 默认是 bash
输出 /bin/zsh → 默认是 zsh

编辑你的 shell 配置文件（根据你使用的 shell）：
对于 zsh (默认)：

echo 'export ANTHROPIC_BASE_URL="https://xh.v1api.cc "' >> ~/.zshrc

echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.zshrc

source ~/.zshrc

bash <(curl -sSL https://cc.585dg.com/run_claude_proxy.sh)

对于 bash：

echo 'export ANTHROPIC_BASE_URL="https://xh.v1api.cc"' >> ~/.bash_profile

echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.bash_profile

source ~/.bash_profile

bash <(curl -sSL https://cc.585dg.com/run_claude_proxy.sh)

以上只需要改动你的API密钥，其他不要变！

(四) 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！
启动 Claude Code

claude

在特定项目中使用

#进入你的项目目录

cd /path/to/your/project# 启动 Claude Codeclaude

(五) macOS 常见问题解决

安装时提示权限错误
尝试以下解决方法：

#使用 sudo 安装

sudo npm install -g @anthropic-ai/claude-code

#或者配置 npm 使用用户目录

npm config set prefix ~/.npm-global

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

source ~/.zshrc

macOS 安全设置阻止运行
如果系统阻止运行 Claude Code：

打开"系统偏好设置" → "安全性与隐私"
点击"仍要打开"或"允许"
或者在 Terminal 中运行：sudo spctl --master-disable
环境变量不生效
检查以下几点：
确认修改了正确的配置文件（.zshrc 或 .bash_profile）
重新启动 Terminal
验证设置：echo $ANTHROPIC_BASE_URL

🎉 恭喜你！
你已经成功安装并配置了 Claude Code，现在可以开始享受 AI 编程助手带来的便利了。
如果在使用过程中遇到任何问题，可以联系我们。

四、Q&A常见问题说明

遇到这种情况是未配置apikey环境变量和base url，请参考上文中重新配置

Linux/macos

export ANTHROPIC_API_KEY="sk-xxxx" # 这里填入你在第二步获取的秘钥。

export ANTHROPIC_BASE_URL=https://xh.v1api.cc

Windows:

$env:ANTHROPIC_API_KEY = "sk-xxxx"

$env:ANTHROPIC_BASE_URL = "https://xh.v1api.cc"

set ANTHROPIC_API_KEY=sk-xxxxxxxxxxf
set ANTHROPIC_BASE_URL=https://xh.v1api.cc

环境变量配置

1、首先，win+R，输入 sysdm.cpl

2、在 “高级”中找到环境变量，在"用户变量"区域点击"新建"

变量名：ANTHROPIC_BASE_URL
变量值：https://xh.v1api.cc

3、建密钥添加到新的环境变量中

变量名：ANTHROPIC_API_KEY
变量值：sk开头的令牌秘钥

最后一步检查

windows下路径为: C:/Users/你的用户名/.claude
Linux 或 macOS 系统中通常位于: ∼/.claude
检查路径下面的 settings.json 里面的ANTHROPIC_API_KEY是否和你购买的密钥一致

2. 需要登录

遇到这种情况

删除.claude文件夹，然后重新按照教程配置
windows下路径为: C:/Users/你的用户名/.claude
Linux 或 macOS 系统中通常位于: ∼/.claude

然后找到这两个路径

windows下路径为: C:/Users/你的用户名
Linux 或 macOS 系统中通常位于: ∼/
新建一个claude.json,把下面代码保存进去

最后重启终端

{"hasCompletedOnboarding": true, "useEnvironmentVariables": true}

3. 输入应该为thinking

再下一个对话框里面发你是谁即可

4. 遇到如下禁止运行脚本怎么办？

以管理员身份打开powershell，输入Set-ExecutionPolicy RemoteSigned -Force回车即可

5. Claude Code 项目路径切换教程

第一步：获取项目文件夹路径

1. 找到你的项目文件夹

在桌面或文件资源管理器中找到你想要使用Claude Code的项目文件夹

2. 获取文件夹完整路径

右键点击项目文件夹
选择"属性"
在属性对话框中找到"位置"字段
复制完整的文件夹路径（例如：C:\Users\Administrator\Desktop\新建文件夹）、

第二步：打开终端
打开以下任意一种终端工具：

命令提示符 (CMD)
PowerShell
Windows Terminal

第三步：切换到项目目录

cd C:\Users\Administrator\Desktop\新建文件夹

*💡 提示：直接输入 cd (注意空格)，然后粘贴刚才复制的路径

按回车键执行命令

第四步：启动Claude Code

输入claude命令

claude

验证是否成功

如果看到以下信息，说明已成功在项目目录中启动Claude Code：

✨ Welcome to Claude Code!

/help for help, /status for your current setup

cwd: C:\Users\Administrator\Desktop\新建文件夹

验证成功标志

当你看到终端显示的当前工作目录 (cwd) 正是你想要的项目路径时，说明切换成功！

6.安装了claude但是运行显示不是内部或外部命令

npm config get prefix

终端里面输入命令然后回车，吧回车后出来的路径添加到系统变量里面重启即可

如果该命令显示乱码的

npm config set prefix C:\npm-global

将全局 npm 包的安装路径设置为 C:\npm-global然后把C:\npm-global添加到系统变量里面重启
重启后再打开终端输入

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/

然后输入claude即可进入claudecode

Claude Code 使用说明