必须将codex接入项目根目录以赋予其完整上下文:桌面端选独立文件夹、vs code插件绑定当前工作区、cli用codex命令或--project指定路径,并注意.gitignore规则需手动配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让Codex真正帮你改代码、跑测试、生成文档,必须先把它“放进”你的项目里——不是复制粘贴文件,而是让它获得对整个文件夹的读写权限和上下文理解能力。这一步做错,后续所有指令都会变成隔空喊话,它根本不知道你指的哪个按钮、哪段逻辑、哪个配置文件。
桌面App中导入本地项目
打开Codex桌面应用,确保已用ChatGPT账号或API Key成功登录。
点击左上角「项目」→「添加新项目」→「使用现有文件夹」。
在弹出窗口中,【必须选择一个非系统关键路径下的独立文件夹】,比如桌面新建的my-test-app,不要选「桌面」「下载」「Documents」这类可能混杂私人文件的目录。
选中后点击「确定」,Codex会立即扫描该目录下的所有文件,建立索引。这个过程通常需要3~15秒,取决于文件数量和大小;扫描完成前,右侧状态栏会显示「正在分析项目结构」。
VS Code插件中绑定当前工作区
确保VS Code已安装Codex官方插件,并通过CC Switch或浏览器授权完成登录。
打开你要操作的项目文件夹(File → Open Folder),让VS Code左侧资源管理器完整显示该项目结构。
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
点击左下角Codex图标 → 选择「Attach to current workspace」。
此时插件右下角会显示绿色小点和「Active」字样,表示Codex已将当前打开的整个工作区识别为任务边界——它现在能准确区分src/utils.js和tests/utils.test.js,而不是胡乱修改任意一个叫utils的文件。
CLI模式下直接进入项目根目录启动
方法一:终端cd进你的项目根目录,执行codex命令,它会自动把当前路径设为工作区。
方法二:在任意路径下运行codex --project /path/to/your/project,强制指定项目位置。
【注意:CLI模式不会自动扫描子目录中的.gitignore规则】,如果你的项目里有node_modules或.env这类敏感目录,务必先确认它们已被正确忽略,否则Codex可能误读或尝试修改这些内容。
首次运行时,Codex会在项目根目录下生成一个隐藏文件.codex/config.json,记录本次会话的上下文锚点。这个文件可安全删除,但删了之后下次进入就得重新扫描。










