📦 Claude Code 安装指南

覆盖 Windows / macOS / Linux 全平台，从环境准备到首次运行，一步到位。

🚀 立即上手 📖 完整指南

🎯 选择你的操作系统

🪟 Windows 安装

第一步：安装 Node.js 环境

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

方法一：使用官方安装包（推荐）

访问 https://nodejs.org/
点击 "LTS" 版本下载（推荐）
下载 Windows Installer (.msi)
运行安装程序，保持默认设置即可
安装完成后重启计算机

方法二：使用 Chocolatey 包管理器

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

# 以管理员身份运行 PowerShell
choco install nodejs

Windows 注意事项

安装过程中会自动配置环境变量
推荐使用 PowerShell 而不是 CMD
某些企业环境可能需要管理员权限

验证安装是否成功

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

node --version
npm --version

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

第二步：安装 Claude Code

打开 PowerShell（建议以管理员身份运行），运行以下命令：

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

验证 Claude Code 安装

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

claude --version

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

第三步：设置环境变量

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

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

在 PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL = "https://use.codecodx.ai/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

💡 记得将 "你的API密钥" 替换为在管理后台 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

使用系统设置（图形界面）：

右键点击"此电脑" → "属性"
点击"高级系统设置"
点击"环境变量"
在"用户变量"中点击"新建"，添加：
- 变量名：ANTHROPIC_BASE_URL
- 变量值：https://use.codecodx.ai/api
再次点击"新建"，添加：
- 变量名：ANTHROPIC_AUTH_TOKEN
- 变量值：你的API密钥
点击"确定"保存

使用 PowerShell（永久设置）：

# 设置用户级环境变量
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://use.codecodx.ai/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", "User")

验证环境变量设置

重新打开 PowerShell，运行以下命令验证设置：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

预期输出示例：

https://use.codecodx.ai/api
cr_xxxxxxxxxxxxxxxxxx

第四步：开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Claude Code
claude

🔧 Windows 常见问题解决

PowerShell 执行策略错误

解决方案：

# 以管理员身份运行 PowerShell，然后执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

npm 权限错误

解决方案：

以管理员身份运行 PowerShell
或者配置 npm 的全局目录到用户文件夹

环境变量不生效

解决方案：

确保重新启动了 PowerShell
检查环境变量是否正确设置
尝试重启计算机

🍎 macOS 安装

第一步：安装 Node.js 环境

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

方法一：使用 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

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

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

在 Terminal 中运行以下命令：

export ANTHROPIC_BASE_URL="https://use.codecodx.ai/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

💡 记得将 "你的API密钥" 替换为在管理后台 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

对于 zsh（默认）：

echo 'export ANTHROPIC_BASE_URL="https://use.codecodx.ai/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export ANTHROPIC_BASE_URL="https://use.codecodx.ai/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

验证环境变量设置

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

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

预期输出示例：

https://use.codecodx.ai/api
cr_xxxxxxxxxxxxxxxxxx

第四步：开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

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

# 启动 Claude Code
claude

🔧 macOS 常见问题解决

安装时提示权限错误

解决方案：

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

# 或者修改 npm 权限
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

macOS 安全设置阻止运行

解决方案：

打开"系统偏好设置" → "安全性与隐私"
在"通用"标签页中，点击"仍要打开"
或者在终端中运行：
```
sudo spctl --master-disable
```

环境变量不生效

解决方案：

确保修改了正确的配置文件（.zshrc 或 .bash_profile）
重新启动终端应用
检查当前使用的 shell：
```
echo $SHELL
```

🐧 Linux 安装

第一步：安装 Node.js 环境

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

方法一：使用官方仓库（推荐）

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

方法二：使用系统包管理器

虽然版本可能不是最新的，但对于基本使用已经足够：

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

Linux 注意事项

某些发行版可能需要安装额外的依赖
如果遇到权限问题，使用 sudo
确保你的用户在 npm 的全局目录有写权限

验证安装是否成功

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

node --version
npm --version

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

第二步：安装 Claude Code

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

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

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

在终端中运行以下命令：

export ANTHROPIC_BASE_URL="https://use.codecodx.ai/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

💡 记得将 "你的API密钥" 替换为在管理后台 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件：

# 对于 bash（默认）
echo 'export ANTHROPIC_BASE_URL="https://use.codecodx.ai/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="https://use.codecodx.ai/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

验证环境变量设置

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

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

预期输出示例：

https://use.codecodx.ai/api
cr_xxxxxxxxxxxxxxxxxx

第四步：开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

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

# 启动 Claude Code
claude

🔧 Linux 常见问题解决

安装时提示权限错误

解决方案：

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

# 或者修改 npm 权限
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

缺少依赖库

解决方案：

# Ubuntu/Debian
sudo apt-get install build-essential

# CentOS/RHEL/Fedora
sudo dnf groupinstall "Development Tools"

环境变量不生效

解决方案：

确保修改了正确的配置文件
重新启动终端
检查当前使用的 shell：
```
echo $SHELL
   
```

🎉 恭喜你！

你已经成功安装并配置了 Claude Code，现在可以开始享受 AI 编程助手带来的便利了。

🚀 下一步

开始第一个项目：在项目目录中运行 claude
探索功能：尝试代码生成、重构、调试等功能
加入社区：获取更多使用技巧和最佳实践

📚 相关资源

使用教程 - 详细的使用指南
完整指南 - 一站式服务指南
拼车服务 - 团队订阅指南

💬 需要帮助？

如果在使用过程中遇到任何问题，可以：

查看上方的常见问题解决方案
访问 GitHub Issues
加入我们的 Telegram 群组