CodeX CLI使用笔记
.md文件:待补充
安装 Codex Cli
# 1. 确保 Node ≥ 22 node -v # v22.5.1 # 2. 一行命令搞定 npm i -g @openai/codex # 3. 验证 codex --version # 0.36.0使用模式
codex # 直接带 prompt codex "帮我重构这个函数" # 完整自动模式(无需确认) codex --full-auto "修复所有 bug"非交互模式(脚本化)
# 执行单个命令,输出 JSON codex exec --json "分析这个文件" > result.json # 输出最后消息到文件 codex exec --output-last-message result.txt "生成报告" # 不保存会话(一次性) codex exec --ephemeral "临时任务"恢复会话
# 列出所有会话 codex resume --all # 恢复最后一个 codex resume --last # 恢复指定会话 codex resume <SESSION_ID> # Fork 会话到新线程 codex fork --last#SESSION_ID 一般这样拿: #如果电脑里面装有jq的话可是通过下面这个命令查看: tail -n 200 ~/.codex/history.jsonl | jq -r '.session_id' | awk '!seen[$0]++' | head -10 #最简单的方式其实是不手动找: #会打开会话选择器 codex resume #这会直接打开会话选择器,直接恢复最近SESSION_ID 有几种拿法,最简单的是其实不用手动找: #如果只是继续最近一次会话,用: codex resume --last #如果你确实要手动拿 SESSION_ID,本机可从这两个地方看: sed -n '1,20p' ~/.codex/history.jsonl # 这里每行都有 session_id,例如: {"session_id":"019da8a2-1320-7402-b5fc-d0e4eae24e3b", ...} # 或者看会话文件名: ls ~/.codex/sessions/2026/04/25 # 你会看到类似: rollout-2026-04-25T17-01-22-019dc3df-4346-72b2-b1e4-e452bad6e22a.jsonl # 其中最后那段 UUID: 019dc3df-4346-72b2-b1e4-e452bad6e22a # 就是可用于: codex resume 019dc3df-4346-72b2-b1e4-e452bad6e22a模型切换
# 命令行指定 codex --model gpt-5.3-codex "任务" # 交互模式内切换 /model gpt-5-codex推理强度调整
# 低强度(快速) codex --config model_reasoning_effort=low "简单任务" # 高强度(深度思考) codex --config model_reasoning_effort=high "复杂架构设计"图片输入
# 单张图片 codex -i screenshot.png "把这个 UI 实现出来" # 多张图片 codex --image design1.png,design2.png "对比这两个设计"代码审查
# 交互模式内执行 /review # 审查特定提交 /review against main # 审查未提交的更改 /review uncommitted网页搜索
# 实时搜索(需要 full access) codex --search "查找最新的 React 19 文档" # 或通过配置 codex --config web_search=live "搜索最新信息"多智能体(实验性)
# 启用多智能体 codex --enable multi_agent "并行处理这个大型项目"MCP 管理
# 添加 MCP 服务器 codex mcp add context7 -- npx -y @upstash/context7-mcp # 列出所有 MCP codex mcp list # 移除 MCP codex mcp remove context7命令行选项完整参考
内置斜杠命令
子命令:
# 云任务 codex cloud list # 列出云任务 codex cloud exec --env prod "部署" # 在指定环境执行 codex apply <TASK_ID> # 应用云任务的 diff # 会话管理 codex resume # 恢复会话 codex fork # Fork 会话 # 工具 codex completion bash # 生成 shell 补全 codex sandbox -- ls # 在沙盒中运行命令 # 功能标志管理 codex features list # 列出功能标志 codex features enable multi_agent # 启用功能 codex features disable <feature> # 禁用功能 # 执行策略检查 codex execpolicy check --rules ~/.codex/rules -- git status # 打开 Codex App codex app /path/to/project # 在指定项目打开 App使用的注意事项:
1.设置上下文压缩域:
步骤打开文件:~/.codex/config.toml
1.可以通过设置: model_auto_compact_token_limit = 220000:你当前设置的主动压缩阈值。会话上下文接近 220k tokens 时,Codex 应尝试压缩旧上下文再继续 model = "gpt-5.5" model_context_window = 272000 model_auto_compact_token_limit = 220000 model_reasoning_effort = "medium" service_tier = "fast" [projects."/Users/linsen"] trust_level = "trusted"