Codex CLI 接入指南
Codex CLI 是一款命令行 AI 编程助手，支持在终端中进行代码生成和问答。
安装
- Windows
- macOS
- Linux
步骤 1：安装 NVM（Node 版本管理器）
打开 PowerShell（管理员模式），下载并安装 nvm-windows：
# 下载 nvm-windows 安装包
# 访问 https://github.com/coreybutler/nvm-windows/releases
# 下载最新的 nvm-setup.exe 并运行安装
或使用 Chocolatey 安装：
choco install nvm
步骤 2：安装 Node.js
# 安装最新 LTS 版本
nvm install lts
# 使用该版本
nvm use lts
# 验证安装
node --version
npm --version
步骤 3：安装 Codex CLI
npm install -g @openai/codex@latest
步骤 4：验证安装
codex --version
步骤 1：安装 NVM
打开终端，使用 curl 或 wget 安装 nvm：
# 使用 curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
# 或使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
步骤 2：加载 NVM
# 添加到配置文件（根据你使用的 shell）
# Bash
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
source ~/.bashrc
# Zsh
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
source ~/.zshrc
步骤 3：安装 Node.js
# 安装最新 LTS 版本
nvm install --lts
# 使用该版本
nvm use --lts
# 验证安装
node --version
npm --version
步骤 4：安装 Codex CLI
npm install -g @openai/codex@latest
步骤 5：验证安装
codex --version
步骤 1：安装 NVM
打开终端，使用 curl 或 wget 安装 nvm：
# 使用 curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
# 或使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
步骤 2：加载 NVM
# 添加到配置文件
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
# 重新加载配置
source ~/.bashrc # 或 source ~/.zshrc
步骤 3：安装 Node.js
# 安装最新 LTS 版本
nvm install --lts
# 使用该版本
nvm use --lts
# 设置默认版本
nvm alias default lts/*
# 验证安装
node --version
npm --version
步骤 4：安装 Codex CLI
npm install -g @openai/codex@latest
步骤 5：验证安装
codex --version
配置 weelinking
- Windows
- macOS
- Linux
步骤 1：创建配置目录
# 创建配置目录
New-Item -Path "$env:USERPROFILE\.codex" -ItemType Directory -Force
步骤 2：创建 config.toml 文件
在 %USERPROFILE%\.codex\ 目录下创建 config.toml 文件：
@"
model_provider = "weelinking"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
[model_providers.weelinking]
name = "weelinking"
base_url = "https://api.weelinking.com/v1"
wire_api = "responses"
requires_openai_auth = true
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8
步骤 3：创建 auth.json 文件
在同一目录下创建 auth.json 文件：
@"
{
"OPENAI_API_KEY": "您的 CodeX 专用分组令牌 key"
}
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\auth.json" -Encoding UTF8
步骤 1：创建配置目录
# 创建配置目录
mkdir -p ~/.codex
步骤 2：创建 config.toml 文件
在 ~/.codex/ 目录下创建 config.toml 文件：
cat > ~/.codex/config.toml << 'EOF'
model_provider = "weelinking"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
[model_providers.weelinking]
name = "weelinking"
base_url = "https://api.weelinking.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
步骤 3：创建 auth.json 文件
在同一目录下创建 auth.json 文件：
cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "您的 CodeX 专用分组令牌 key"
}
EOF
步骤 1：创建配置目录
# 创建配置目录
mkdir -p ~/.codex
步骤 2：创建 config.toml 文件
在 ~/.codex/ 目录下创建 config.toml 文件：
cat > ~/.codex/config.toml << 'EOF'
model_provider = "weelinking"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
[model_providers.weelinking]
name = "weelinking"
base_url = "https://api.weelinking.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
步骤 3：创建 auth.json 文件
在同一目录下创建 auth.json 文件：
cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "您的 CodeX 专用分组令牌 key"
}
EOF
使用方法
交互模式
codex
直接执行
codex "写一个 Python 快速排序算法"
管道输入
- Windows
- macOS
- Linux
Get-Content code.py | codex "解释这段代码"
cat code.py | codex "解释这段代码"
cat code.py | codex "解释这段代码"
功能特色
- 代码生成：根据描述生成代码
- 代码解释：解释代码逻辑
- 命令行集成：与 shell 无缝协作
- 多语言支持：支持各种编程语言
推荐模型
| 场景 | 模型 |
|---|---|
| 代码生成 | gpt-5.2-codex |
| 快速问答 | gpt-4o-mini |
| 复杂任务 | claude-sonnet-4-5 |
常见问题
命令找不到
- Windows
- macOS
- Linux
确保 npm 全局安装路径在系统 PATH 中：
# 查看 npm 全局路径
npm config get prefix
# 如需添加到 PATH，在系统环境变量中添加：
# %APPDATA%\npm
确保 npm 全局安装路径在 PATH 中：
# 查看 npm 全局路径
npm config get prefix
# 添加到 PATH（如果还没有）
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc
确保 npm 全局安装路径在 PATH 中：
# 查看 npm 全局路径
npm config get prefix
# 添加到 PATH（如果还没有）
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc
API 连接失败
- 检查
~/.codex/config.toml配置是否正确 - 验证
~/.codex/auth.json中的 API Key 是否有效 - 确认网络连接正常
Node.js 版本问题
Codex CLI 需要 Node.js 18 或更高版本：
# 检查版本
node --version
# 如果版本过低，使用 nvm 升级
nvm install --lts
nvm use --lts