Codex通过三种方式准确锁定项目根目录:一是启动时用--cd参数指定绝对或相对路径;二是桌面端通过「+新建项目」手动选择目录并创建.codex/子目录;三是对话中用@符号临时引用文件或/mention命令触发自动工作区推测。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Codex准确识别并锁定你的项目根目录,避免它在错误路径下生成文件或读取配置,必须通过明确的路径指定方式完成设置。
启动时用--cd参数指定工作目录
这是最直接、最可靠的方式,适用于所有CLI和TUI模式。
第一步:打开终端,进入任意目录(不需要先进入项目目录)。
第二步:执行命令 codex tui --cd /path/to/your/project 或 codex exec "任务" --cd /path/to/your/project。
第三步:Codex会立即切换上下文,所有后续操作(读文件、写文件、运行测试)都以该路径为基准。此时 【若指定目录不存在,命令将直接报错退出,不会静默降级到当前目录】。
相对路径也支持,比如 codex tui -C ./my-app,但注意该路径是相对于你执行命令时所在的目录,不是相对于~或/。
在桌面端界面中手动绑定项目目录
适合不常使用命令行、偏好图形化操作的用户。
点击左侧栏底部的「+ 新建项目」按钮。
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
在弹出窗口中,点击「选择文件夹」,浏览并选中你的项目根目录(例如包含 .env、app/、config/ 的那个文件夹)。
确认后,Codex会自动在该目录下创建 .codex/ 子目录用于存储会话元数据,并将此路径设为默认工作区。
这一步完成后,你在该项目下的所有对话都会共享这个根路径,无需重复设置。
用@符号临时引用文件来反向锚定项目
当你已经处于某个对话中,但发现Codex当前没在正确目录下工作,可以用文件路径“拉回”上下文。
方法一:在输入框中键入 @ 后开始输入,比如 @config/database.php,从下拉列表中选择目标文件。
方法二:直接写完整路径,如 请分析 /Users/alice/myapp/config/app.php 中的时区配置。
方法三:用 /mention 命令显式加载整个目录,例如输入 /mention ./src,Codex会把该目录纳入当前对话的感知范围。
注意:这种方式不会永久修改项目根目录,只影响当前对话的文件可见性;但它能触发Codex自动向上查找最近的 .codex/ 或 .env 文件,从而推测出合理的工作区。

















