什么是 Codex CLI?

Codex CLI 是一款轻量级的命令行 AI 编程助手,支持代码生成、解释、调试等功能,并可灵活切换多种 AI 模型。相比 Claude Code,它更轻量、启动更快,适合快速问答场景。

  • 命令行交互,无需图形界面
  • 支持 GPT、Claude、Gemini 等多模型
  • 代码生成、解释、调试一体化
  • 支持管道输入,与 Git 工作流无缝集成
  • 通过 LuckyAPI 中转,成本仅官方 6%

支持的模型

模型适用场景推荐指数
gpt-5.4日常编程、快速问答⭐⭐⭐⭐⭐ 推荐
gpt-5.3-codex-xhigh复杂算法、代码优化⭐⭐⭐⭐
claude-opus-4-6大规模重构、架构设计⭐⭐⭐⭐⭐
claude-sonnet-4-6日常开发、均衡选择⭐⭐⭐⭐

系统要求

项目要求
Node.js16.0 及以上
npm7.0 及以上
操作系统macOS、Linux(推荐),Windows 建议用 WSL2

一键配置(推荐)

bash curl -fsSL https://code.claudexai.com/codex-install.sh | bash

脚本自动完成:Node.js 检测、Codex CLI 安装、配置目录创建、API 信息写入。

手动配置

  1. 安装 Codex CLI

    bash npm config set registry https://registry.npmmirror.com npm install -g @openai/codex
  2. 创建认证文件

    bash mkdir -p ~/.codex cat > ~/.codex/auth.json <<'EOF' { "token": "你的LuckyAPI密钥", "baseUrl": "https://api.claudexai.com" } EOF
  3. 创建配置文件

    bash cat > ~/.codex/config.toml <<'EOF' [defaults] model = "gpt-5.4" temperature = 0.2 [api] base_url = "https://api.claudexai.com" EOF

使用示例

启动交互模式

codex

直接提问

codex "用 Python 写一个快速排序函数"

解释代码文件

codex explain ./src/main.py

调试错误

python app.py 2>&1 | codex "帮我修复这个错误"

指定模型

codex --model claude-opus-4-6 "重构这段代码"

Windows 专项说明

Windows 推荐方案 Windows 用户推荐直接使用 VS Code 插件,体验更好。若坚持使用命令行,请先安装 WSL2。
powershell # 安装 WSL2(管理员 PowerShell) wsl --install # 然后在 WSL2 中按 Linux 方式安装

进阶技巧

设置命令别名

bash # 添加到 ~/.bashrc 或 ~/.zshrc alias cx="codex" alias cxe="codex explain"

与 Git 集成

bash # 让 AI 生成 commit message git diff --staged | codex "根据这些改动生成一条 git commit message"

常见问题

Q:配置文件在哪里?

配置文件位于 ~/.codex/ 目录,包含 auth.json(认证)和 config.toml(默认设置)。

Q:如何切换模型?

使用 --model 参数临时切换,或修改 config.toml 中的 model 字段永久生效。

Q:API Key 如何获取?

前往 LuckyAPI 配置页 注册获取,价格仅为官方的 6%。