必须先运行 codex /init 生成 agents.md 作为认知锚点,再通过 --chat 交互、单行指令或斜杠命令(/goal、/scope、/plan、/run)创建任务,所有操作均需在含技术栈文件的项目根目录下进行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在终端中用 Codex CLI 创建一个可执行、有上下文、能修改文件的编程任务,必须明确目标、限定范围、指定验收方式,不能只说“帮我写个功能”。
准备项目环境
进入你希望 Codex 操作的项目根目录,确保该目录下有可识别的技术栈文件(如 package.json、requirements.txt、pyproject.toml 或 Cargo.toml)。Codex 会基于这些文件自动推断语言、框架和依赖关系。
如果目录为空或只有零散脚本,Codex 将无法建立有效上下文,后续任务可能反复要求你手动指定模型、路径或格式。
运行 codex /init。这一步会扫描整个目录,生成 AGENTS.md 文件,把技术栈、代码风格、架构约定全部固化下来。这是所有后续任务的“认知锚点”,【跳过此步会导致每次任务都需重复描述项目背景】。
启动交互式任务会话
在已执行过 /init 的项目目录中,直接运行:
codex --chat
终端将进入多轮对话模式,顶部显示当前项目路径与 AGENTS.md 中识别出的核心约束。此时你可以像跟资深同事结对一样描述问题:
“登录页点击提交后按钮没置灰,导致重复请求;请在 src/pages/Login.vue 中给 el-button 添加 loading 属性,并在 submit 方法里控制开关。”
Codex 会先确认文件路径、检查现有逻辑、提出修改方案,再等待你输入 y 批准执行。它不会擅自覆盖,每处变更都会展示 diff。
用单行指令创建轻量任务
适合快速生成函数、补全脚本、转换数据格式等不涉及多文件协调的场景。
方法一:直接提问
codex "用 Python 写一个函数,接收字符串列表,返回按长度降序排列的新列表,忽略空字符串"
Codex 立即输出完整可运行代码,不修改任何本地文件,也不执行命令。
方法二:带文件上下文的精准修改
codex "把 utils/helpers.py 里的 format_date 函数改成支持 ISO 格式输入,并加类型提示"
它会读取该文件,定位函数,生成修改建议,并询问是否写入——【必须当前目录下存在 utils/helpers.py,否则报错退出】。
用结构化指令发起复杂任务
当需求包含多个步骤、需调用命令、验证结果时,用斜杠命令明确阶段划分:
第一步:初始化任务上下文
codex /goal "修复用户注册接口的邮箱唯一性校验漏洞"
第二步:限定影响范围
/scope "backend/api/auth.py, backend/models/user.py, tests/test_auth.py"
第三步:设定执行策略
/plan "1. 检查 User.create() 是否调用邮箱去重逻辑 → 2. 若缺失,在 create 前添加数据库查询 → 3. 在 tests/test_auth.py 中补充重复邮箱注册的 400 测试用例"
第四步:执行并确认
/run
每步执行前 Codex 都会列出拟运行的命令(如 pytest tests/test_auth.py -k duplicate)、拟修改的行号和 diff 预览,你输入 y 后才真正落盘。











