Codex可通过四种方式实现项目自动识别:一是修改全局配置文件指定默认工作目录;二是创建带--cd参数的快捷方式或PowerShell脚本;三是项目根目录下添加.codex/config.toml声明项目元信息;四是在AGENTS.md中定义路径别名以支持语义化路径引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让 Codex 每次启动时自动识别你最常开发的几个项目,而不是每次都要手动拖入文件夹或重新选择路径——这能省下大量重复操作时间,避免因选错目录导致修改扩散到无关文件。
设置全局默认项目路径
Codex 本身不记忆“最近打开”,但可通过配置文件强制它每次启动都加载指定目录。编辑全局配置文件 ~/.codex/config.toml,在末尾添加:
workspace.cwd = "D:\Projects\my-web-app"
这个路径必须是绝对路径,且指向一个真实存在的、含 .git 或 package.json 的有效项目根目录。如果路径不存在,Codex 启动时会静默失败,不报错也不加载任何项目。
为不同项目创建独立快捷方式
方法一:桌面快捷方式配参数
右键新建快捷方式,目标栏填:codexapp --cd "D:Projectsackend-api"
方法二:PowerShell 封装脚本
新建 backend.ps1,内容为:Start-Process codexapp "--cd D:Projectsackend-api"
双击该脚本即可直接进入对应项目。注意:PowerShell 默认禁止执行本地脚本,需先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 授权。
用项目配置文件绑定上下文
第一步:在你要长期使用的项目根目录下,新建 .codex/config.toml
第二步:写入关键字段:
[project]
name = "电商订单系统"
description = "React + NestJS 全栈项目,主入口在 /web-client 和 /api"
第三步:保存后,在 Codex 桌面端左侧 Projects 面板中点击刷新图标 → 该项目会自动出现在列表顶部,带名称和描述。
这个配置文件不会被全局配置覆盖,优先级更高。只要项目目录存在且含此文件,Codex 就能把它当“正式项目”识别,而非普通文件夹。
通过 AGENTS.md 声明常用路径别名
在项目根目录下创建 AGENTS.md,开头写:
```yaml
paths:
src: ./web-client/src
api: ./api/src
docs: ./docs
```
Codex 读取该文件后,会在对话中理解 “src” 指代前端源码目录,“api” 指代后端目录。你后续提问时可直接说:“在 src 下新增 hooks/useAuth.ts”,它会自动映射到完整路径。
这个别名只对当前项目生效,不跨项目共享。但它是唯一能让 Codex “记住路径语义”的方式——不是记路径字符串,而是记路径含义。


















