ℹ️
Windows 系统 Claude Code 配置指南
本教程将指导你在 Windows 系统上安装和配置 Claude Code AI 编程工具。
1

安装 Node.js 环境

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

ℹ️
Windows 安装方法

方法一:官网下载(推荐)

  1. 打开浏览器访问 https://nodejs.org/
  2. 点击 "LTS" 版本进行下载(推荐长期支持版本)
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装,保持默认设置即可

方法二:使用包管理器

# 使用 Chocolatey 或 Scoop
choco install nodejs
# 或使用 Scoop
scoop install nodejs
验证安装是否成功

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

node --version
npm --version

如果显示版本号,说明安装成功了!

2

安装 Claude Code

打开 PowerShell 或 CMD,运行以下命令:

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

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

验证 Claude Code 安装

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

claude --version

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

3

配置 Claude Code 环境变量

⚠️
重要说明
为了让 Claude Code 连接到中转服务,需要设置环境变量。

方法一:PowerShell 临时设置(当前会话)

$env:ANTHROPIC_BASE_URL = "https://uyilink.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

方法二:PowerShell 永久设置(用户级)

# 设置用户级环境变量(永久生效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://uyilink.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
ℹ️
验证 Claude Code 环境变量
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
ℹ️
VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:

配置文件位置:C:\Users\你的用户名\.claude\config.json

💡 如果该文件不存在,请手动创建。

{
  "primaryApiKey": "uyiapi"
}
💡
小贴士
设置完成后,记得重新打开 PowerShell 窗口以使永久环境变量生效。
4

开始使用 Claude Code

🎉
恭喜!现在你可以使用 Claude Code 强大的 AI 编程助手了!
Claude Code 非常适合复杂的代码重构、架构设计、文档编写和代码审查。

🤖 Claude Code

claude

适合复杂的代码重构、架构设计、文档编写和代码审查。

ℹ️
macOS 系统 Claude Code 配置指南
本教程将指导你在 macOS 系统上安装和配置 Claude Code AI 编程工具。主要使用 Terminal 和 export 命令。
1

安装 Node.js 环境

ℹ️
使用 Homebrew 安装(推荐)
# 安装 Homebrew(如果没有)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 使用 Homebrew 安装 Node.js
brew install node
node --version
npm --version
2

安装 Claude Code

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

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

claude --version

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

3

配置 Claude Code 环境变量

# 添加到 ~/.zshrc 或 ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://uyilink.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
ℹ️
VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:

配置文件位置:~/.claude/config.json

💡 如果该文件不存在,请手动创建。

{
  "primaryApiKey": "uyiapi"
}
4

开始使用 Claude Code

🎉
恭喜!现在你可以使用 Claude Code 强大的 AI 编程助手了!
Claude Code 非常适合复杂的代码重构、架构设计、文档编写和代码审查。

🤖 Claude Code

claude

适合复杂的代码重构、架构设计、文档编写和代码审查。

ℹ️
Linux / WSL2 系统 Claude Code 配置指南
支持主流 Linux 发行版和 WSL2 环境,使用包管理器安装。
1

安装 Node.js 环境

Ubuntu/Debian
# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
CentOS/RHEL
# 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs
Arch Linux
sudo pacman -S nodejs npm
2

安装 Claude Code

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
⚠️
权限问题解决

如果遇到 EACCES 权限错误,配置 npm 使用用户目录:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
验证 Claude Code 安装

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

claude --version

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

3

配置 Claude Code 环境变量

# 添加到 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://uyilink.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
ℹ️
VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:

配置文件位置:~/.claude/config.json

💡 如果该文件不存在,请手动创建。

{
  "primaryApiKey": "uyiapi"
}
4

开始使用 Claude Code

🎉
恭喜!现在你可以使用 Claude Code 强大的 AI 编程助手了!
Claude Code 非常适合复杂的代码重构、架构设计、文档编写和代码审查。

🤖 Claude Code

claude

适合复杂的代码重构、架构设计、文档编写和代码审查。