TUTORIAL

接入教程

选择工具和操作系统，按步骤完成安装与 Sub2API 配置，约 3 分钟。

选择工具
选择操作系统
Codex 简介
OpenAI Codex CLI 是 OpenAI 官方推出的命令行 AI 编程助手，类似于 Claude Code，但使用 OpenAI 的模型（如 GPT-4o、o1、o3 等）。通过 Sub2API 接入，无需海外信用卡，直接用人民币充值调用。
推荐使用 WSL 或 Git Bash
Codex 在 Windows 上推荐使用 WSL（Windows Subsystem for Linux）安装和运行，兼容性最好。如果不想装 WSL，至少使用 Git Bash 来运行 Codex。PowerShell 兼容性较差，可能遇到文件锁定、写入失败（error write file）等问题。

0前置要求：安装 Git

Codex 在 Windows 下依赖 Git Bash 运行。前往 git-scm.com 下载安装，保持默认选项。安装后重启终端验证：

POWERSHELL
git --version

1安装 Node.js 和 Codex

Codex CLI 通过 npm 安装，需要 Node.js 18+。

安装 Node.js
POWERSHELL
# WinGet（推荐）
winget install OpenJS.NodeJS.LTS

# 或前往官网下载
# https://nodejs.org/
POWERSHELL · 验证
node --version
npm --version
安装 Codex CLI
POWERSHELL / BASH
npm install -g @openai/codex

# 国内镜像（下载慢可用）
npm install -g @openai/codex --registry=https://registry.npmmirror.com
验证安装
POWERSHELL
codex --version

2配置环境变量

按 Win+X → 选择「终端管理员」，运行（替换为你的域名和 Key）：

POWERSHELL · 管理员
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.your-domain.com/v1", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-sub2-YOUR_KEY", [System.EnvironmentVariableTarget]::Machine)

设置后需重新打开终端才能生效。

验证
POWERSHELL
Get-ChildItem Env:OPENAI_*
之前用过其他中转？清理旧配置
POWERSHELL · 管理员
# 检查现有配置
Get-ChildItem Env:OPENAI_*
# 清理
[Environment]::SetEnvironmentVariable('OPENAI_BASE_URL', $null, 'Machine')
[Environment]::SetEnvironmentVariable('OPENAI_API_KEY',  $null, 'Machine')

3启动 Codex

BASH / GIT BASH
# 进入项目目录
cd /c/path/to/your/project

# 启动（推荐在 Git Bash 或 WSL 中运行）
codex
首次运行会进行初始化。若提示登录 OpenAI，选择跳过或直接使用 API Key 模式（已通过 OPENAI_API_KEY 环境变量配置）。
Codex 简介
OpenAI Codex CLI 是 OpenAI 官方推出的命令行 AI 编程助手，类似于 Claude Code，但使用 OpenAI 的模型（如 GPT-4o、o1、o3 等）。通过 Sub2API 接入，无需海外信用卡，直接用人民币充值调用。
macOS 默认 shell 为 zsh（可通过 echo $SHELL 确认）。推荐使用系统「终端」或 iTerm2。

1安装 Node.js 和 Codex

安装 Node.js
BASH
# Homebrew（推荐）
brew install node

# 或 nvm（多版本管理）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc
nvm install --lts
安装 Codex CLI
BASH
npm install -g @openai/codex

# 国内镜像
npm install -g @openai/codex --registry=https://registry.npmmirror.com
验证安装
BASH
codex --version

2配置环境变量

编辑 ~/.zshrc（或 ~/.bash_profile）：

BASH
# 打开配置文件
nano ~/.zshrc

# 在末尾添加（替换为你的域名和 Key）：
export OPENAI_BASE_URL="https://api.your-domain.com/v1"
export OPENAI_API_KEY="sk-sub2-YOUR_KEY"

# 保存（Ctrl+O → Enter → Ctrl+X），然后应用：
source ~/.zshrc
验证
BASH
env | grep OPENAI
之前用过其他中转？清理旧配置
BASH
# 检查现有配置
env | grep OPENAI
# 编辑 ~/.zshrc，删除旧的 OPENAI_* 行
nano ~/.zshrc

3启动 Codex

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

# 启动
codex
首次运行会进行初始化。若提示登录 OpenAI，选择跳过或使用 API Key 模式（已通过 OPENAI_API_KEY 环境变量配置）。
推荐使用 WSL 或 Git Bash
Claude Code 在 Windows 原生 PowerShell/CMD 下可能遇到文件锁定、路径问题。推荐使用 WSL 或 Git Bash 安装和运行。若必须使用 PowerShell，请以管理员权限运行。
推荐安装 Windows Terminal（微软官方现代终端，多标签 + 更好的中文显示），可从 Microsoft Store 免费获取。

0前置要求：安装 Git

Claude Code 依赖 Git 运行。若启动后看到以下错误，说明需要先安装 Git：

ERROR
Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).
If installed but not in PATH, set environment variable:
  CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

前往 git-scm.com 下载安装，保持默认选项。安装后重启终端验证：

POWERSHELL
git --version
Git 已安装但提示找不到 bash？自动检测路径
POWERSHELL · 管理员
$p = @(
  "$env:ProgramFiles\Git\bin\bash.exe",
  "${env:ProgramFiles(x86)}\Git\bin\bash.exe",
  "$env:LOCALAPPDATA\Programs\Git\bin\bash.exe"
)
$f = $p | Where-Object { Test-Path $_ } | Select-Object -First 1
if ($f) {
    [Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", $f, "Machine")
    "已设置: $f"
} else { "未找到 Git，请先安装" }

1安装 Claude Code

官方推荐，无需 Node.js，后台自动更新：

POWERSHELL
irm https://claude.ai/install.ps1 | iex
POWERSHELL
winget install Anthropic.ClaudeCode
WinGet 不会自动更新，需手动运行 winget upgrade Anthropic.ClaudeCode。
已被官方标记弃用，需要 Node.js 18+。
POWERSHELL
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
验证安装
POWERSHELL
claude --version

2配置环境变量

按 Win+X → 选择「终端管理员」，运行（替换为你的域名和 Key）：

POWERSHELL · 管理员
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.your-domain.com", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-sub2-YOUR_KEY", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "3000000", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::Machine)

设置后需重新打开终端才能生效。

验证
POWERSHELL
Get-ChildItem Env:ANTHROPIC_*

3启动 Claude Code

POWERSHELL / BASH
cd C:\path\to\your\project
claude
首次启动会进行初始化。若弹出登录提示，按 Esc 跳过（已通过环境变量配置了 Key）。
macOS 默认 shell 为 zsh（可通过 echo $SHELL 确认）。推荐使用系统「终端」或 iTerm2。

1安装 Claude Code

官方推荐，无需 Node.js，后台自动更新：

BASH
curl -fsSL https://claude.ai/install.sh | sh
BASH
brew install claude-code
已被官方标记弃用，需要 Node.js 18+。
BASH
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
验证安装
BASH
claude --version

2配置环境变量

BASH
# 打开配置文件
nano ~/.zshrc

# 在末尾添加（替换为你的域名和 Key）：
export ANTHROPIC_BASE_URL="https://api.your-domain.com"
export ANTHROPIC_AUTH_TOKEN="sk-sub2-YOUR_KEY"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# 保存后应用：
source ~/.zshrc
验证
BASH
env | grep ANTHROPIC

3启动 Claude Code

BASH
cd /path/to/your/project
claude
首次启动会进行初始化。若弹出登录提示，按 Esc 跳过（已通过环境变量配置了 Key）。
注册即送免费额度
按量计费 · 无月租 · 随时停止
免费注册 → 查看定价