AI Agent / 系统课时
使用集成终端
使用集成终端
集成终端把“执行命令、观察结果、让 Codex 继续分析”放在同一个任务里。关键不是少切一次窗口,而是让命令运行在当前项目或 Worktree 的正确目录,并把测试、构建、Git 状态等真实输出变成下一轮工作的证据。
学习目标
- 能确认集成终端当前绑定的项目或 Worktree,避免在错误目录执行命令。
- 能运行验证命令并读懂关键输出,再让 Codex 基于输出继续处理。
- 能识别长进程、敏感信息和破坏性命令带来的操作边界。
先确认终端作用域
桌面应用中的终端跟随当前会话,作用域是这个会话所在的项目或 Worktree。打开终端后,先看当前目录和 Git 分支,而不是立刻运行安装、测试或提交命令。这样可以防止你以为自己在 Local,实际却位于另一个工作树。
可从应用右上角的终端入口打开终端;当前版本也提供 Ctrl + 反引号键作为快捷入口。如果你的快捷键经过自定义,应以当前应用设置显示为准。
用命令确认当前位置
先执行只读命令确认仓库根目录和当前分支。下面的命令适用于 Git 项目,不会修改文件。
git rev-parse --show-toplevel
git status --short --branch预期输出
<PATH>
## <BRANCH><PATH> 和 <BRANCH> 会随你的仓库变化;如果工作区存在未提交修改,后面还会出现 M、A、?? 等状态行。确认位置无误后,再运行项目自己的验证命令,例如 npm test、pytest、go test ./... 或仓库规定的 lint、构建脚本。
让终端输出成为下一轮证据
Codex 可以读取当前集成终端的输出,因此命令失败后,不必先凭感觉改代码。保留失败现场,然后直接要求它基于终端内容判断问题,例如:“读取当前终端输出,指出失败的第一处根因;先说明证据,再修改代码并给出重新验证命令。”
这种工作方式尤其适合测试失败、类型检查报错、构建错误和开发服务器日志。输出过长时,优先重跑更聚焦的命令,让错误附近的内容留在当前终端,而不是一次塞入几万行历史日志。
正确处理长进程和敏感输出
开发服务器、监听器和测试 watch 模式会长期占用终端。需要持续观察时可以保留进程;需要执行下一条命令时,新开终端标签或先安全停止进程。不要为了让 Codex“看到更多”而随意运行删除文件、重置分支、覆盖数据库等破坏性命令。
终端继承的是你的真实开发环境,输出里可能出现绝对路径、内部地址、环境变量或凭据。执行 env、调试认证请求或打印配置前先判断是否会泄露秘密;一旦输出包含令牌或密钥,应立即停止传播并按团队流程轮换,而不是继续把它当普通调试信息使用。
集成终端最可靠的用法是形成一个短闭环:运行最小验证命令 → 保留原始输出 → 让 Codex 基于证据修复 → 再运行同一验证命令。当命令重新通过且 Git 状态符合预期,这个任务才算真正完成。