Skip to content

OpenAI Codex 安装配置指南 ​


OpenAI Codex 是一个强大的AI代码生成工具,能够理解自然语言并生成高质量的代码。本指南将帮助您完成 Codex 的安装和配置。

什么是 OpenAI Codex? ​

OpenAI Codex 是 OpenAI 开发的AI编程助手,基于GPT模型训练,专门用于:

  • 代码生成和补全
  • 代码解释和文档生成
  • 编程问题解答
  • 多种编程语言支持

系统要求 ​

基础要求 ​

  • 操作系统 : Windows 10/11, macOS 10.14+, Linux Ubuntu 18.04+
  • Python : 3.7 或更高版本
  • 网络连接 : 需要稳定的互联网连接
  • API访问权限 : OpenAI API 账户

推荐配置 ​

  • 8GB+ 内存
  • 稳定的网络环境
  • 现代代码编辑器(VS Code, PyCharm 等)

安装步骤 ​

1. 安装 OpenAI Codex CLI ​

方法一:npm 全局安装(推荐) ​

bash

npm install -g @openai/codex

方法二:Homebrew 安装(macOS) ​

bash

brew install codex

方法三:直接下载二进制文件 ​

访问 GitHub Releases 页面,下载适合您系统的二进制文件:

支持的平台:

  • macOS (Apple Silicon/arm64 和 x86_64)
  • Linux (x86_64 和 arm64)

安装步骤:

  1. 下载对应平台的二进制文件
  2. 解压到系统 PATH 目录
  3. 确保文件具有执行权限

bash

# 示例:Linux/macOS
chmod +x codex
sudo mv codex /usr/local/bin/

2. 验证安装 ​

bash

# 检查版本
codex --version

# 启动 CLI
codex

# 绕过审批和沙盒模式启动(高级用法)
codex --dangerously-bypass-approvals-and-sandbox

注意 : --dangerously-bypass-approvals-and-sandbox 参数会绕过安全审批和沙盒限制,请谨慎使用。

2. 环境配置 ​

方法1:PowerShell命令(推荐) ​

powershell

$env:OPENAI_BASE_URL = "你的url"
$env:OPENAI_API_KEY = "你的key"

方法2:命令提示符(CMD) ​

cmd

set OPENAI_BASE_URL=你的url
set OPENAI_API_KEY=你的key

方法3:永久设置(通过setx命令) ​

cmd

setx OPENAI_BASE_URL "你的url"
setx OPENAI_API_KEY "你的key"

永久设置(添加到系统环境变量) ​

**macOS/Linux:**
```bash
# 临时设置
export OPENAI_BASE_URL="你的url"
export OPENAI_API_KEY="你的key"

# 永久设置(添加到 ~/.bashrc 或 ~/.zshrc)
echo 'export OPENAI_BASE_URL="你的url"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="你的key"' >> ~/.bashrc

source ~/.bashrc

Codex 配置文件 ​

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

model_provider = "crs"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.crs]
name = "crs"
base_url = "你的url"
wire_api = "responses"

在 ~/.codex/auth.json 文件中配置API密钥:

json

{
"OPENAI_API_KEY": "你的API密钥"
}

💡 使用与 Claude Code 相同的 API 密钥即可,格式如 cr_xxxxxxxxxx。

相关资源 ​

下一步 ​

安装完成后,您可以:

  1. 探索不同的编程语言支持
  2. 尝试更复杂的代码生成任务
  3. 集成到您的开发工具链中
  4. 学习高级提示工程技巧

需要帮助?加入我们的 拼车社群,获得专业技术支持!