🎉 欢迎使用 AI合租 文档系统!返回主站 →
文档中心
💻 Codex CLI
安装 Codex CLI(Mac/Linux)

安装 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。