codex需在正确项目目录下运行以避免文件定位错误,可通过启动时--cd参数、tui中/cd命令或配置文件三种方式指定工作目录,并用/status和list命令验证路径是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Codex在指定目录下运行代码生成、文件修改或命令执行任务,但当前它正基于错误的路径工作,导致找不到AGENTS.md、无法读取配置、修改文件时写入了无关位置。
启动时直接指定新项目目录
这是最常用也最安全的方式,适用于你尚未进入交互界面,或刚打开终端准备启动Codex的场景。
第一步:确保目标目录存在且包含必要项目文件(如package.json、AGENTS.md或.codex/config.json)。
第二步:在终端中切换到任意位置,直接用--cd参数启动Codex:
codex tui --cd /path/to/your/project
或简写为:
codex tui -C ./my-backend
这会强制Codex将/path/to/your/project或./my-backend设为工作根目录,所有后续读写、命令执行、文件定位都以此为基准。相对路径./my-backend是相对于你当前终端所在目录解析的,不是相对于项目内部。
【若指定目录不存在,Codex会报错退出,不会自动创建】
在已运行的交互界面中切换目录
当你已经进入Codex TUI界面,但发现当前上下文不在正确项目里,无需退出重开,可用内置命令即时切换。
输入斜杠命令:
/cd /home/user/projects/frontend-vue
或使用相对路径:
/cd ../api-service
执行后Codex会立即重新扫描该目录下的文件索引,并加载AGENTS.md和配置。注意:/cd命令仅在TUI模式下有效,CLI exec模式不支持运行时切换。
切换成功后,右上角显示的“X files indexed”数量会刷新,且/status中显示的workspace.cwd字段将更新为你刚设置的路径。
永久变更默认项目目录
如果你长期在某个固定路径开发,不想每次启动都加--cd,可通过配置文件固化工作目录。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法一:编辑全局配置
运行codex --profile default config edit,在打开的配置文件中添加:
workspace: cwd: "/home/user/my-main-project"
方法二:在项目根目录放置.codex/config.yaml
手动创建该文件,内容为:
cwd: "./"
该配置优先级低于命令行--cd,但高于启动时的当前目录。只要Codex在该项目目录或其子目录中启动,就会自动采用此路径。
【注意:配置中的cwd值必须是相对路径(如./)或绝对路径,不能是环境变量或波浪号~】
验证目录是否已正确切换
无论用哪种方式切换,都必须立刻验证,避免后续操作误伤其他项目。
在TUI中输入:
/status
查看输出中Workspace root一行是否为你期望的路径。
再运行:
codex list --files 3
检查列出的文件是否属于目标项目——比如看到src/App.vue而非node_modules/...,说明切换成功。
如果/status仍显示旧路径,说明--cd参数未生效或/cd命令输错,此时应停止所有修改操作,先排查路径拼写与权限问题。










