Skip to Content

Codex CLI

Codex CLI 是 OpenAI 推出的命令行编程助手，支持在终端中以自然语言描述任务，自动生成并执行代码。通过 AcceleAI 接入，你可以使用 GPT 系列及其他兼容模型。

安装

通过 npm 安装：

npm install -g @openai/codex

也可以从 OpenAI 官网  下载 macOS 桌面版。

配置文件

Codex CLI 通过两个配置文件连接 AcceleAI 服务。

config.toml

编辑 ~/.codex/config.toml：

profile = "acceleai"
 
[model_providers.acceleai]
name = "acceleai"
base_url = "https://api.acceleai.cn/v1"
personality = "pragmatic"
wire_api = "responses"
 
[profiles.acceleai]
model = "gpt-5"
model_provider = "acceleai"
model_reasoning_effort = "high"

你可以根据需要修改 model 字段，例如切换为 gpt-4.1 或其他 AcceleAI 支持的模型。

auth.json

编辑 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "<ACCELE_AI_API_KEY>"
}

API Key 可在 AcceleAI 控制台  获取。

终端使用

配置完成后，进入你的项目目录并启动：

cd your-project
codex

首次运行时会提示配置权限级别，选择适合的模式后即可开始使用。直接输入自然语言描述你的需求，Codex 将自动生成代码方案。

桌面客户端

  1. 启动 Codex 桌面应用
  2. 选择工作目录
  3. 在输入框中描述任务即可

桌面版的模型和 Provider 配置同样读取上述配置文件。

命令参考

codex [options]

选项：
  -h, --help                 显示帮助信息
  -m, --model <model>        指定模型（默认：codex-mini-latest）
  -i, --image <path>         附加图片文件路径
  -v, --view <rollout>       查看已保存的会话
  -q, --quiet                非交互模式，仅输出最终结果
  -a, --approval-mode <mode> 审批模式：suggest / auto-edit / full-auto
  --auto-edit                自动批准文件编辑
  --full-auto                自动批准所有沙箱内操作
  --no-project-doc           不加载 codex.md 项目文档
  --project-doc <file>       指定要加载的 Markdown 项目文档
  --full-stdout              不截断命令输出
  -f, --full-context         将整个仓库加载到上下文

常用示例

# 指定模型启动
codex -m gpt-5
 
# 全自动模式
codex --full-auto
 
# 静默模式，适合脚本调用
codex -q "重构这个函数以提高性能"
ClineGemini CLI