一键安装（推荐）

使用一键安装脚本，自动完成 Node.js 和 Claude Code 的安装，最简单快捷！

如何打开 PowerShell：

  1. 按下键盘上的 Win + X 组合键
  2. 在弹出的菜单中选择"Windows PowerShell"或"终端"
  3. 或者：按 Win 键，输入"PowerShell"，然后回车

在 PowerShell 中运行以下命令：

# 一键安装 Claude Code 
curl -fsSL https://claude.ai/install.sh | bash
⚠️

重要提示

  • 此命令需要访问国际网络，请确保你的网络环境可以访问 claude.ai
  • 如果无法访问，需要使用代理工具（梯子）
  • 安装脚本会自动安装 Node.js 和 Claude Code，无需手动安装其他依赖

验证安装

安装完成后，运行以下命令检查：

# 检查版本 
claude --version

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

下一步：配置环境变量

安装完成后，还需要配置环境变量才能正常使用。你有两个选择：

方法一：使用 cc-switch 快速配置（推荐）

cc-switch 是一个可视化配置工具，可以帮你快速配置环境变量：

  1. 从 GitHub 下载 cc-switch 工具
  2. 打开工具，根据界面示输入你的 API 密钥
  3. 点击配置按钮可自动完成环境变量设置
下载地址：https://github.com/farion123/cc-switch

方法二：手动配置环境变量

请查看下方的「步骤 3：设置环境变量」，进行手动配置

1

手动安装：安装 Node.js 环境

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

Windows 安装方法 二选一，推荐方法一

方法一：官网下载（推荐）

  1. 打开浏览器访问 Node.js 下载页面
  2. 点击 "LTS" 版本进行下载（推荐长期支持版本）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey 
choco install nodejs
# 或使用 Scoop 
scoop install nodejs
ℹ️

Windows 注意事项

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

验证安装是否成功

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

# 检查版本 
node --version
npm --version

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

2

手动安装：安装 Claude Code

使用 npm 安装 Claude Code

打开 PowerShell 或 CMD 后，运行以下命令：

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

⚠️

常见报错：PowerShell 执行策略限制

如果在运行 npm 命令时出现以下错误：

npm : 无法加载文件 D:\\Program Files\\nodejs\\npm.ps1,
因为在此系统上禁止运行脚本。
解决方案：
  1. 以管理员身份打开 PowerShell：
    • 右键点击开始菜单
    • 选择"Windows PowerShell (管理员)"或"终端 (管理员)"
  2. 运行以下命令：
    # 设置执行策略 
    Set-ExecutionPolicy RemoteSigned
  3. 确认更改：

    当系统询问时，输入 Y 或者 A，然后回车。

  4. 重新运行安装命令：

    可以关闭管理员窗口，打开普通 PowerShell 窗口，再次运行 npm install -g @anthropic-ai/claude-code 命令。

完成后，npm 命令即可以正常使用了。

验证 Claude Code 安装

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

# 检查版本 
claude --version

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

⚠️

提示：如果运行 claude --version 时显示"命令 Git Bash，请参考下方"步骤 4"的 Git 相关配置方案。

3

设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

PowerShell 设置方法

永久设置（强烈推荐）

在 PowerShell 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量（永久生效） 
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://openapi.troncode.cn",
[System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥",
[System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

临时设置（当前会话有效，不推荐）

在 PowerShell 中运行以下命令：

# 临时设置环境变量 
$env:ANTHROPIC_BASE_URL = "https://openapi.troncode.cn"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

关闭窗口后设置会失效。

CMD 设置方法

永久设置（强烈推荐）

在 CMD 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量 
setx ANTHROPIC_BASE_URL "https://openapi.troncode.cn"
setx ANTHROPIC_AUTH_TOKEN "你的API密钥"

设置后需要重新打开 CMD 窗口才能生效。

临时设置（当前会话有效，不推荐）

在 CMD 中运行以下命令：

# 临时设置环境变量 
set ANTHROPIC_BASE_URL=https://openapi.troncode.cn
set ANTHROPIC_AUTH_TOKEN=你的API密钥

关闭窗口后设置会失效。

记得替换 "你的API密钥" 替换为实际密钥。

验证环境变量设置

设置完环境变量后，可以通过以下命令验证：

PowerShell:
# 查看环境变量 
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
CMD:
# 查看环境变量 
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
4

开始使用 Claude Code

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

启动 Claude Code

# 启动命令 
claude

首次启动后，第一次启动 claude 时，会自动一键配置环境，查看所有环境是否正确，查看你的环境是否正确，查看你的环境是否正确。

在特定项目中使用

# 进入项目目录 
cd C:\path\to\your\project
# 启动 Claude Code
claude

常见提示：

如果在运行 claude 命令时出现以下错误：

Claude Code on Windows requires git-bash...

解决方案：

  1. 下载 Git：
  2. 安装 Git：

    双击下载的安装包，一路点击"下一步"，保持默认设置即可。

  3. 重新启动 Claude：

    安装完成后，重新打开 PowerShell 或 CMD，运行：

    # 重新启动 
    claude

✅ Git 安装成功后，Claude 命令可以正常运行了。

Windows 常见问题解法

安装时报 "permission denied" 错误

这通常是权限问题，尝试以下方法：

  • 以管理员身份运行 PowerShell
  • 或在原有命令前添加：npm config set prefix %APPDATA%\npm

PowerShell 执行脚本被禁用

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

# 设置执行策略 
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后仍不生效

设置永久环境变量后需要：

  • 重新启动 PowerShell 或 CMD
  • 或者注销并重新登录 Windows
  • 验证设置：echo $env:ANTHROPIC_BASE_URL

一键安装（推荐）

使用一键安装脚本，自动完成 Node.js 和 Claude Code 的安装，最简单快捷！

打开 Terminal，运行以下命令：

# 一键安装 Claude Code 
curl -fsSL https://claude.ai/install.sh | bash
⚠️

重要提示

  • 此命令需要访问国际网络，请确保你的网络环境可以访问 claude.ai
  • 如果无法访问，需要使用代理工具（梯子）
  • 安装脚本会自动安装 Node.js 和 Claude Code，无需手动安装其他依赖

验证安装

安装完成后，运行以下命令检查：

# 检查版本 
claude --version

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

配置环境变量

安装完成后，还需要配置环境变量才能正常使用。你有两个选择：

方法一：使用 cc-switch 快速配置（推荐）

cc-switch 是一个可视化配置工具，可以帮你快速配置环境变量：

  1. 从 GitHub 下载 cc-switch 工具
  2. 打开工具，根据界面提示输入你的 API 密钥
  3. 点击配置按钮，可自动完成环境变量设置
下载地址：https://github.com/farion123/cc-switch
方法二：手动配置环境变量

请查看下方的「步骤 1：手动安装 Node.js 环境」，进行手动配置

1

手动安装：安装 Node.js 环境

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

macOS 安装方法 二选一，推荐方法一

方法一：官网下载（推荐）

  1. 打开浏览器访问 Node.js 下载页面
  2. 点击 "LTS" 版本进行下载（推荐长期支持版本）
  3. 下载完成后双击 .pkg 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用 Homebrew

如果你安装了 Homebrew，可以使用命令行安装：

# 使用 Homebrew 安装 
brew install node
ℹ️

macOS 注意事项

  • 推荐使用 Homebrew 安装，更方便管理版本
  • 如果遇到权限问题，可能需要使用 sudo
  • 某些版本的 macOS 可能需要安装 Xcode Command Line Tools

验证安装是否成功

安装完成后，打开终端，输入以下命令：

# 检查版本 
node --version
npm --version

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

2

手动安装：安装 Claude Code

使用 npm 安装 Claude Code

打开 Terminal，运行以下命令：

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

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

# 使用 sudo 安装 
sudo npm install -g @anthropic-ai/claude-code

验证 Claude Code 安装

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

# 检查版本 
claude --version

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

3

设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：临时设置（当前会话）

在 Terminal 中运行以下命令：

# 设置环境变量 
export ANTHROPIC_BASE_URL="https://openapi.troncode.cn"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
方法二：永久设置

编辑你的 shell 配置文件：

# 对于 zsh（默认） 
echo 'export ANTHROPIC_BASE_URL="https://openapi.troncode.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# 对于 bash 
echo 'export ANTHROPIC_BASE_URL="https://openapi.troncode.cn"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile
4

开始使用 Claude Code

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

启动 Claude Code

# 启动命令 
claude

在特定项目中使用

# 进入你的项目目录 
cd /path/to/your/project

# 启动 Claude Code
claude

一键安装（推荐）

使用一键安装脚本，自动完成 Node.js 和 Claude Code 的安装，最简单快捷！

打开终端，运行以下命令：

# 一键安装 Claude Code 
curl -fsSL https://claude.ai/install.sh | bash
⚠️

重要提示

  • 此命令需要访问国际网络，请确保你的网络环境可以访问 claude.ai
  • 如果无法访问，需要使用代理工具（梯子）
  • 安装脚本会自动安装 Node.js 和 Claude Code，无需手动安装其他依赖

验证安装

安装完成后，运行以下命令检查：

claude --version

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

下一步：配置环境变量

安装完成后，还需要配置环境变量才能正常使用。你有两个选择：

方法一：使用 cc-switch 快速配置（推荐）

cc-switch 是一个可视化配置工具，可以帮你快速配置环境变量：

  1. 从 GitHub 下载 cc-switch 工具
  2. 打开工具，根据界面提示输入你的 API 密钥
  3. 点击配置按钮即可自动完成环境变量设置
下载地址：https://github.com/farion123/cc-switch
方法二：手动配置环境变量

请查看下方的「步骤 3：设置环境变量」，进行手动配置

1

手动安装：安装 Node.js 环境

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

Linux 安装方法

Ubuntu / Debian:
# 更新包管理器 
sudo apt update
# 安装 Node.js 
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
CentOS / RHEL / Fedora:
# 安装 Node.js 
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install nodejs
Arch Linux:
# 安装 Node.js 
sudo pacman -S nodejs npm

验证安装是否成功

安装完成后，输入以下命令：

node --version
npm --version
2

手动安装：安装 Claude Code

使用 npm 安装 Claude Code

打开终端，运行以下命令：

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

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

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

验证 Claude Code 安装

claude --version
3

设置环境变量

配置 Claude Code 环境变量

临时设置（当前会话）
export ANTHROPIC_BASE_URL="https://openapi.troncode.cn"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
永久设置

编辑你的 shell 配置文件：

# 对于 bash 
echo 'export ANTHROPIC_BASE_URL="https://openapi.troncode.cn"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
4

开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude