如果想让 Codex 自动识别项目并记住常用工程路径,常见方案主要有四种:第一,直接修改全局配置文件,提前设置默认工作目录;第二,创建带有--cd参数的快捷方式,或编写一段 PowerShell 启动脚本;第三,在项目根目录新增.codex/config.toml,用于声明项目元信息;第四,在AGENTS.md中定义路径别名,从而支持更语义化的路径调用与引用。

如果你希望 Codex 在每次启动时都能自动识别自己最常开发的几个项目,而不是反复手动拖入文件夹或重新选择项目路径,那么提前做好这些配置会非常实用。这不仅能减少重复操作,还能降低因目录选错而误改无关文件的风险,提升日常开发效率。
设置全局默认项目路径
Codex 默认不会记录“最近打开的项目”,但你可以通过配置文件指定固定目录,让它在启动时自动加载对应项目。编辑全局配置文件 ~/.codex/config.toml,并在末尾添加:
workspace.cwd = "D:\Projects\my-web-app"
这里填写的路径必须是绝对路径,并且要指向一个真实存在的有效项目根目录,通常目录中应包含 .git 或 package.json 等项目标识文件。如果路径不存在或目录无效,Codex 启动时通常会静默失败,既不会报错,也不会自动加载项目。
为不同项目创建独立快捷方式
方法一:使用桌面快捷方式传入参数
右键新建快捷方式,目标栏填写:codexapp --cd "D:Projectsbackend-api"
方法二:通过 PowerShell 封装启动脚本
新建 backend.ps1,内容为:Start-Process codexapp "--cd D:Projectsbackend-api"
双击该脚本后,即可直接打开并进入对应项目。需要注意的是,PowerShell 默认通常禁止执行本地脚本,因此要先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 完成授权,否则脚本可能无法正常执行。
用项目配置文件绑定上下文
第一步:在你准备长期维护或频繁打开的项目根目录下,新建 .codex/config.toml
第二步:写入关键字段:
[project]
name = "电商订单系统"
description = "React + NestJS 全栈项目,主入口在 /web-client 和 /api"
第三步:保存后,在 Codex 桌面端左侧 Projects 面板中点击刷新图标 → 该项目会自动显示在列表顶部,并附带项目名称和描述信息。
这个配置文件不会被全局配置覆盖,优先级也更高。只要项目目录存在且包含该文件,Codex 就能将其识别为“正式项目”,而不只是一个普通文件夹。这也是让 Codex 自动识别项目上下文的常用方式之一。
通过 AGENTS.md 声明常用路径别名
在项目根目录下创建 AGENTS.md,开头写:
```yaml
paths:
src: ./web-client/src
api: ./api/src
docs: ./docs
```
Codex 读取该文件后,会在对话中正确理解 “src” 代表前端源码目录,“api” 代表后端源码目录。这样你在后续提问时就可以直接说:“在 src 下新增 hooks/useAuth.ts”,它会自动映射到完整项目路径,减少重复输入路径的麻烦。
这种路径别名只对当前项目生效,不会在多个项目之间共享。但它也是目前唯一能让 Codex “记住路径语义”的方式——它记住的不是单纯的路径字符串,而是不同目录在项目中的实际含义与用途。
