跳转到主要内容

​
概览

OpenAI Codex 是一款开源命令行工具 (CLI)，作为一个轻量级编程智能体，能够在终端中读取、修改和运行代码。它基于 GPT 模型构建，并针对代码生成进行了优化。

​
系统要求

  • 操作系统：macOS, Linux (官方支持), Windows (通过 WSL)
  • Node.js：18+ 版本
  • npm：10.x.x 或更高版本

​
安装

sudo npm install -g @openai/codex@latest
验证安装： 
codex --version

​
配置

​
步骤 1：设置 API Key

临时（当前会话）： 
export OPENAI_API_KEY="sk-your-lemondata-key"
永久配置： 添加到 ~/.bashrc、~/.zshrc 或 ~/.bash_profile： 
export OPENAI_API_KEY="sk-your-lemondata-key"
然后重新加载： 
source ~/.zshrc  # 或 source ~/.bashrc

​
步骤 2：配置 config.toml

编辑 ~/.codex/config.toml： 
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
如果配置文件不存在，请运行一次 codex 以生成该文件，然后再进行编辑。

​
基本用法

启动交互模式： 
codex
直接命令： 
codex "Fix the bug in main.py line 42"
指定模型： 
codex -m gpt-4o "Build a REST API server"

​
可用模型

模型最适用于
gpt-4o复杂的编程任务、架构设计
gpt-4o-mini快速修复、简单任务
claude-sonnet-4-5代码审查、文档编写
deepseek-r1算法设计、推理

​
交互式命令

命令描述
/help显示帮助
/exit 或 Ctrl+C退出
/clear清除对话
/config查看配置
/model <name>切换模型
/tokens查看 token 使用情况

​
验证配置

# 检查环境变量
echo $OPENAI_API_KEY

# 测试 API 连接
codex "Hello, Codex!"

# 查看配置
cat ~/.codex/config.toml

​
常见使用场景

代码审查： 
git diff | codex "Review these code changes"
生成提交信息： 
git diff --staged | codex "Generate a commit message for these changes"
修复错误： 
codex "Fix the TypeScript errors in src/components/"
解释代码： 
cat main.py | codex "Explain what this code does"

​
故障排除

  • 验证 config.toml 中的 base_url 是否准确为 https://api.lemondata.cc/v1
  • 检查网络连接
  • 确保没有代理干扰
  • 验证 OPENAI_API_KEY 环境变量是否已设置
  • 检查 Key 是否以 sk- 开头
  • 确保该 Key 在 LemonData 控制面板中处于激活状态