Codex 中转介绍

⚙️ 命令速查

Codex CLI 常用命令、参数与快捷键速查表。

基本命令

命令说明
codex进入交互模式
codex "<prompt>"单次执行
codex -从 stdin 读取 prompt
codex --version查看版本
codex --help帮助
codex config show查看当前生效配置
codex config edit$EDITOR 打开 config.toml
codex auth重新登录 / 管理 Key

常用参数

参数短参示例说明
--model-m-m gpt-5.5临时切换模型
--reasoning-r-r xhigh推理强度 low/medium/high/xhigh
--continue-c-c接续上一次会话
--session-s-s mysession命名会话便于恢复
--no-stream--no-stream关闭流式(一次性返回)
--system--system "你是 Go 专家"注入 system prompt
--file-f-f src/main.ts把文件作为上下文
--dir-d-d ./src把目录作为上下文
--exec-e-e允许 Codex 执行 shell 命令
--json--json以 JSON 输出,便于脚本管道

交互模式快捷键

快捷键动作
Ctrl+C中断当前生成 / 退出
Ctrl+D结束多行输入
Ctrl+L清屏
Ctrl+R在历史中搜索
Esc Esc编辑上一次输入
/help列出 slash 命令
/model <name>切换模型
/clear清空当前会话上下文
/save <name>保存当前会话
/load <name>加载会话
/cost查看当前会话 Token 消耗
/files列出已加载的上下文文件
/exit/quit退出

常见场景示例

解释一段代码

codex "解释这段代码" -f src/parser.ts

跨文件重构

codex -d ./src "把所有 callback 改写成 async/await,保留原有行为"

让 Codex 自己跑测试

codex -e "实现 utils/date.ts 里的 formatRelative 函数,写完跑 npm test"

从 stdin 接受输入

git diff main | codex "总结这个 diff 的主要变化,生成 PR 描述"

流式响应导出到文件

codex --json "生成一份 React 组件 props 类型定义" > props.ts

与历史会话延续

codex -s feature-auth "为登录加 2FA"
# ...继续对话
codex -s feature-auth -c "再补一下短信验证码部分"

临时调用更强模型

# 默认 gpt-5.4,临时换 gpt-5.5 + xhigh 推理
codex -m gpt-5.5 -r xhigh "review 这次 PR 的架构问题" -f CHANGES.md

环境变量覆盖

变量作用
OPENAI_API_KEY覆盖 auth.json 里的 Key
CODEX_CONFIG指向自定义 config.toml 路径
CODEX_LOG_LEVELdebug / info / warn / error
CODEX_NO_COLOR设为 1 关闭彩色输出
HTTPS_PROXY走 HTTP 代理(极少需要)

工作流速查

最佳实践

Prompt 写法、上下文管理、调试技巧

通知配置

长任务完成提醒、余额到期通知