安装 Codex CLI(Mac/Linux)
本指南将帮助你在 macOS 或 Linux 系统上安装和配置 Codex CLI。
第一步:安装 Codex CLI
根据你的系统选择合适的安装方法:
方法一:npm 安装(推荐)
# 全局安装 Codex CLI
npm install -g @openai/codex
# 验证安装
codex --version方法二:Homebrew 安装(macOS)
# 更新 Homebrew
brew update
# 安装 Codex CLI
brew install codex
# 验证安装
codex --version方法三:直接下载(所有平台)
# 下载最新版本
curl -sSL https://releases.openai.com/codex/install.sh | bash
# 添加到 PATH
echo 'export PATH="$HOME/.codex/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc第二步:配置 Codex 环境变量
1. 配置 Codex 配置文件
在 ~/.codex/config.toml 文件开头添加以下配置:
model_provider = "aihezu"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.aihezu]
name = "aihezu"
base_url = "https://cc.aihezu.dev/openai"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"2. 配置 API 密钥
在 ~/.codex/auth.json 文件中配置 API 密钥:
{
"OPENAI_API_KEY": null
}提示:将
OPENAI_API_KEY设置为null,然后设置环境变量CRS_OAI_KEY为你的 API 密钥。
3. 设置环境变量
临时设置(仅当前终端会话有效)
export CRS_OAI_KEY=你的API密钥永久设置(推荐)
将环境变量添加到你的 shell 配置文件中:
对于 zsh(macOS 默认):
echo "export CRS_OAI_KEY=你的API密钥" >> ~/.zshrc
source ~/.zshrc对于 bash:
echo "export CRS_OAI_KEY=你的API密钥" >> ~/.bash_profile
source ~/.bash_profile注意:请将
你的API密钥替换为你实际的 API 密钥。
验证安装
配置完成后,你可以通过以下命令验证 Codex CLI 是否正确安装和配置:
codex --version下一步
安装和配置完成后,你可以开始使用 Codex CLI 了。建议查看 VS Code 集成了解如何在编辑器中使用 Codex。