AI Agent / 系统课时

打开本地项目

打开本地项目

本课解决 Codex 从错误目录启动、误读其他仓库或把已有改动混入任务的问题。你将从仓库根目录启动 Codex,并在交付任务前确认当前路径、Git 分支和工作区是否干净。

学习目标

  • 确认终端当前目录就是目标仓库
  • 识别分支、未提交改动和未跟踪文件
  • 从正确工作区启动 Codex

启动前确认仓库边界

Codex 会把启动时选择的目录作为主要工作区。若你在仓库上级目录启动,它可能看到多个无关项目;若在子目录启动,又可能缺少根目录中的配置、脚本和 AGENTS.md。最稳妥的做法是先进入仓库根目录,再检查 Git 识别出的顶层路径。

任务开始前还要查看工作区状态。已有改动并不一定要提交,但必须知道哪些文件原本就被修改过,避免把自己的旧改动误认为 Codex 新生成的内容。重要任务建议先建立 Git 检查点。

在仓库根目录启动

下面以一个已经克隆到本机的项目为例。请把 <PATH> 替换为真实路径。

bash
cd <PATH>/my-app
pwd
git rev-parse --show-toplevel
git status --short --branch
codex

预期输出

text
<PATH>/my-app
<PATH>/my-app
## feature/demo
<Codex interactive interface opens in this directory>

pwd 与 git rev-parse --show-toplevel 应指向同一个目录。git status --short --branch 第一行显示当前分支;其余行若出现 M、A、D 或 ??,表示工作区并非干净,需要先判断这些改动是否与本次任务有关。实际分支名、路径和界面版本可能不同。

处理已有改动

工作区有改动时,不要直接让 Codex“大范围整理项目”。先用 git diff --stat 了解影响范围,再决定提交、暂存或保留。若这些改动必须保留,可以在第一条任务指令中明确说明“现有改动不是本次任务的一部分,不要覆盖或回退”。

bash
git diff --stat
git diff --name-only

预期输出

text
src/example.ts | <N> +++++-----
<N> file changed, <N> insertions(+), <N> deletions(-)
src/example.ts

当输出为空时,表示没有未暂存的已跟踪文件改动;未跟踪文件仍需通过 git status --short 检查。

启动后的首次确认

进入 Codex 后,先用一句短指令核对边界,例如:“只读取当前仓库,告诉我仓库根目录、当前分支和未提交文件,不要修改任何内容。”如果结果与终端检查不一致,应立即退出并从正确目录重新启动,而不是继续补充解释。

首次接触陌生仓库时,先只读确认,再进入修改阶段。目录错误会让后续分析、测试和差异审查全部失去可信基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

打开本地项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通