Claude Code & Codex 使用教程

安装 Node.js 环境

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

Windows 安装方法

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

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

方法二：使用包管理器

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

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项

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

验证安装是否成功

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

node --version
npm --version

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

安装 Git Bash

Windows 系统下建议使用 git bash 而非 PowerShell 来运行 Claude Code，避免遇到各种依赖问题。

⚠️ 下载安装 Git for Windows

访问 https://git-scm.com/download/win
点击 "Download for Windows" 下载安装包
双击安装，建议保持默认选项
安装完成后可以在任意文件夹右键选择 "Open Git Bash here" 来打开

注意事项

安装过程中保持默认选项即可
安装完成后，Git Bash 会自动添加到右键菜单
推荐使用 Git Bash 而不是 Command Prompt 或 PowerShell
如果已经安装过 Git，可以跳过此步骤

Git Bash 验证

# 验证 Git 安装成功
git --version

安装 Claude Code

⚠️ 安装 Claude Code

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

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

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

提示

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，以管理员身份运行 PowerShell

验证 Claude Code 安装

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

claude --version

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

安装 Codex

如果你也想使用 Codex，可以通过以下方式安装：

# 全局安装 Codex
npm install -g @openai/codex

验证 Codex 安装：

codex --version

设置环境变量

⚠️ 配置 Claude Code 环境变量

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

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

在 PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL = "https://code.aitianhu5.top/api/"
$env:ANTHROPIC_AUTH_TOKEN = "你的cr_开头的key"

💡 记得将 "你的cr_开头的key" 替换为你赞助领到的key。

方法二：PowerShell 永久设置（用户级）

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

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://code.aitianhu5.top/api/", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的cr_开头的key", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

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

验证环境变量设置

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

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

预期输出示例：

https://code.aitianhu5.top/api/
cr_xxxxxxxxxxxxxxxxxx

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

配置 Codex 环境变量

如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：

在 ~/.codex/config.toml 文件中添加以下配置：

model_provider = "crs"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://code.aitianhu5.top/openai/"
wire_api = "responses"
requires_openai_auth = true

在 ~/.codex/auth.json 文件中配置key：

{
"OPENAI_API_KEY": "你的cr_开头的key"
}

💡 使用与 Claude Code 相同的key即可，格式如 cr_xxxxxxxxxx。

开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

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

启动 Codex

如果你安装了 Codex，可以这样启动：

codex

在特定项目中使用 Codex：

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

Windows 常见问题解决

问题1: 安装时提示 "permission denied" 错误

解决方法：

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

问题2: PowerShell 执行策略错误

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

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

问题3: 环境变量设置后不生效

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

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

安装 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 已经成功安装了。

安装 Codex

如果你也想使用 Codex，可以通过以下方式安装：

# 全局安装 Codex
npm install -g @openai/codex

# 如果遇到权限问题，可以使用 sudo
sudo npm install -g @openai/codex

验证 Codex 安装：

codex --version

设置环境变量

⚠️ 配置 Claude Code 环境变量

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

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

在 Terminal 中运行以下命令：

export ANTHROPIC_BASE_URL="https://code.aitianhu5.top/api/"
export ANTHROPIC_AUTH_TOKEN="你的cr_开头的key"

💡 记得将 "你的cr_开头的key" 替换为你赞助领到的key。

方法二：永久设置

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

对于 zsh (默认)：

echo 'export ANTHROPIC_BASE_URL="https://code.aitianhu5.top/api/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的cr_开头的key"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export ANTHROPIC_BASE_URL="https://code.aitianhu5.top/api/"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的cr_开头的key"' >> ~/.bash_profile
source ~/.bash_profile

配置 Codex 环境变量

在 ~/.codex/config.toml 文件中添加以下配置：

model_provider = "crs"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://code.aitianhu5.top/openai/"
wire_api = "responses"
requires_openai_auth = true

在 ~/.codex/auth.json 文件中配置key：

{
"OPENAI_API_KEY": "你的cr_开头的key"
}

💡 使用与 Claude Code 相同的key即可，格式如 cr_xxxxxxxxxx。

开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude

启动 Codex

如果你安装了 Codex，可以这样启动：

codex

在特定项目中使用 Codex：

# 进入你的项目目录
cd /path/to/your/project
# 启动 Codex
codex

macOS 常见问题解决

问题1: 安装时提示权限错误

解决方法：

使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
或者配置 npm 使用用户目录：npm config set prefix ~/.npm-global

问题2: macOS 安全设置阻止运行

如果系统阻止运行 Claude Code：

打开“系统偏好设置” → “安全性与隐私”
点击“仍要打开”或“允许”
或者在 Terminal 中运行：sudo spctl --master-disable

问题3: 环境变量不生效

检查以下几点：

确认修改了正确的配置文件（.zshrc 或 .bash_profile）
重新启动 Terminal
验证设置：echo $ANTHROPIC_BASE_URL

安装 Node.js 环境

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

🐧 Linux 安装方法

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

# 添加 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

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

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

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

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

验证 Claude Code 安装

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

claude --version

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

安装 Codex

如果你也想使用 Codex，可以通过以下方式安装：

# 全局安装 Codex
npm install -g @openai/codex

# 如果遇到权限问题，可以使用 sudo
sudo npm install -g @openai/codex

验证 Codex 安装：

codex --version

设置环境变量

⚠️ 配置 Claude Code 环境变量

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

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

在终端中运行以下命令：

export ANTHROPIC_BASE_URL="https://code.aitianhu5.top/api/"
export ANTHROPIC_AUTH_TOKEN="你的cr_开头的key"

💡 记得将 "你的cr_开头的key" 替换为你赞助领到的key。

方法二：永久设置

编辑你的 shell 配置文件：

对于 bash (默认)：

echo 'export ANTHROPIC_BASE_URL="https://code.aitianhu5.top/api/"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的cr_开头的key"' >> ~/.bashrc
source ~/.bashrc

对于 zsh：

echo 'export ANTHROPIC_BASE_URL="https://code.aitianhu5.top/api/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的cr_开头的key"' >> ~/.zshrc
source ~/.zshrc

配置 Codex 环境变量

在 ~/.codex/config.toml 文件中添加以下配置：

model_provider = "crs"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://code.aitianhu5.top/openai/"
wire_api = "responses"
requires_openai_auth = true

在 ~/.codex/auth.json 文件中配置key：

{
"OPENAI_API_KEY": "你的cr_开头的key"
}

💡 使用与 Claude Code 相同的key即可，格式如 cr_xxxxxxxxxx。

开始使用 Claude Code

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

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude

启动 Codex

如果你安装了 Codex，可以这样启动：

codex

在特定项目中使用 Codex：

# 进入你的项目目录
cd /path/to/your/project
# 启动 Codex
codex

Linux 常见问题解决

问题1: 安装时提示权限错误

解决方法：

使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
或者配置 npm 使用用户目录：npm config set prefix ~/.npm-global
然后添加到 PATH：export PATH=~/.npm-global/bin:$PATH

问题2: 缺少依赖库

某些 Linux 发行版需要安装额外依赖：

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

问题3: 环境变量不生效

检查以下几点：

确认修改了正确的配置文件（.bashrc 或 .zshrc）
重新启动终端或运行 source ~/.bashrc
验证设置：echo $ANTHROPIC_BASE_URL