Claude Code Windows使用指南

推荐优先下载

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

一、Windows安装方法

(一) 安装Node.js环境

官网下载
1. 下载并双击安装即可：https://nodejs.org/ （选择 LTS 版）

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

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

Windows 注意事项

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

4.验证安装是否成功

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

node -v

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

npm -v

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

二、配置淘宝镜像（国内强烈推荐）

打开 PowerShell 或 CMD，输入以下命令：

npm config set registry https://registry.npmmirror.com/

三、安装git

1.下载：https://git-scm.com/
一路 Next。
验证：

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

git -v

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

---

安装 Claude Code

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

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

2. 打开终端输入以下命令

claude --version

> 提示「不是内部或外部命令」时，执行 npm config get prefix，把输出路径加入系统 Path，重启终端

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

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

4.关闭并重新打开终端后输入 claude 即可,后面一直回车

5. 如果要换模型这种形式输入即可 /model deepseek-chat

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

方法二：官网下载

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

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 连接到你的中转服务，需要设置两个环境变量：

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常见问题说明

1. Invalid API key • Please run /login

遇到这种情况是未配置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"

• cmd

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

第三步：切换到项目目录

1. 使用cd命令切换目录

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

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

2. 按回车键执行命令

第四步：启动Claude Code

1. 输入claude命令

claude

2. 验证是否成功

如果看到以下信息，说明已成功在项目目录中启动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