要让Codex作为智能体参与开发，必须将其置于Agent Space中运行，以支持文件操作、命令执行与测试运行；需登录客户端、创建本地项目沙盒、启用Code模式并配置gpt-4o-mini等支持Computer Use的模型，再通过AGENTS.md注入项目上下文，最后用自然语言或分步指令驱动真实开发任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Codex真正作为智能体参与项目开发，而不是只在聊天框里输出代码片段，必须把它放进Agent Space中运行——这是它调用本地文件、执行命令、修改代码、运行测试的必要环境。
确认Codex已安装并能登录
打开Codex桌面客户端，使用ChatGPT账号或OpenAI API Key完成登录。若卡在手机号验证环节，【国内用户必须提前准备一个可接收短信的境外号码，或使用herosms等平台代收验证码】。登录成功后，界面左下角应显示“Online”状态。
如果启动后空白无响应，检查是否以管理员身份运行；若仍失败，关闭软件，重新以管理员权限启动一次。
创建专属Agent Space（项目沙盒）
点击主界面上方「+ New Space」按钮 → 选择「Local Folder」→ 浏览并选中你的目标项目根目录（例如包含package.json或pyproject.toml的文件夹）→ 点击「Confirm」。
这一步不可跳过：Codex只有在明确绑定的Agent Space中，才能读取.gitignore、识别模块依赖、理解tsconfig.json或pylint配置。脱离Space的对话，它默认只能当“高级ChatGPT”用。
首次加载可能需要10–30秒，右上角出现项目路径和文件树图标即表示Space已激活。
启用Code模式并设置模型
进入刚创建的Space后，点击右上角齿轮图标 → 在「Mode」中切换为「Code」（不是Ask）→ 在「Model」下拉菜单中手动选为gpt-4o-mini或gpt-4-turbo（免费用户默认仅开放gpt-4o-2024-05-13，但该模型不支持Computer Use能力）。
注意：若未切换到Code模式，所有“修改文件”“运行npm test”类指令都会被静默忽略，不会报错也不会执行。
切换完成后，点击「Save & Reload」使配置生效。
投喂AGENTS.md建立项目上下文
在项目根目录新建一个纯文本文件，命名为AGENTS.md（必须全大写、全英文、带.md后缀）。
用以下四块内容填充（每块之间空一行）：
① 构建和测试命令：
```bash
npm run build
npm test -- --runInBand
```
② 编码规范（只写差异项）：
“API路由统一放在src/routes/下，文件名用kebab-case；所有React组件必须用TSX，props接口命名以Props结尾。”
③ 红线规则：
“禁止修改node_modules下的任何文件；禁止提交.env、.gitignore、package-lock.json变更。”
④ 代码定位策略：
“搜索优先级：先查src/lib/工具函数 → 再查src/features/业务模块 → 最后查src/app/入口逻辑。”
保存后，在Codex当前Space中输入：“重载AGENTS.md”，它会立即解析并缓存全文。此后每次新对话，它都自动以此为行动依据。
发起第一个真实Agent任务
方法一：自然语言指令直接驱动
在对话框中输入：“修复src/features/auth/login.tsx中useMutation返回值类型错误，它当前推导为any，应改为LoginResponse类型。改完后运行npm test验证。” → 按回车。
方法二：分步控制（推荐复杂任务）
第一步：输入“不要写代码，先列出修复login.tsx类型错误的完整执行计划，包括要修改哪几行、需补充哪些import、是否需更新test文件”。
第二步：等它返回编号步骤后，回复“按计划第1、2、3步执行”。
第三步：收到修改结果后，再输入“运行npm test并反馈失败用例详情”。
Codex会在后台自动打开文件、编辑、保存、终端执行命令、捕获输出，并将结果结构化返回。整个过程无需你手动切窗口或复制粘贴。
