AI Agent / 系统课时

准备开发环境

准备开发环境

在安装 Codex 前,应先确认终端能进入目标仓库、Git 状态可追踪、编辑器可打开项目,并且网络能够完成登录和模型请求。本课给出一套最小检查清单,避免把环境问题误判成 Codex 故障。

学习目标

  • 检查 Codex 使用所需的基础开发条件
  • 验证项目目录和 Git 工作区状态
  • 提前识别权限、网络和工具链问题

检查基础条件

Codex CLI 可在 macOS、Linux 和 Windows 上使用;桌面应用面向 Windows 与 macOS。无论选择哪种入口,都应准备可用终端、Git、目标项目和项目自身需要的构建或测试工具。

编辑器不是 CLI 的强制依赖,但建议安装并确认能够打开仓库。Codex 会调用本机已有命令,因此 Java、Node.js、Python、容器或数据库客户端是否需要安装,取决于当前项目,而不是 Codex 本身。

验证 Git 与项目目录

在目标仓库根目录执行以下命令。它们分别检查 Git 版本、当前位置是否属于工作树,以及当前是否存在未提交改动。

bash
git --version
git rev-parse --is-inside-work-tree
git status --short

预期输出

text
git version <VERSION>
true
<NO_OUTPUT>

<NO_OUTPUT> 表示工作区干净;如果第三条命令列出文件,应先确认这些改动是否需要保留。Codex开始编辑前最好创建提交或分支,确保可以快速比较和回退。

检查目录与权限

确认当前用户对项目目录具有读取权限;需要本地修改时,还要有写入权限。不要把首次练习放在系统目录、生产挂载目录或包含大量无关仓库的父目录中。

项目的构建、测试和格式化命令也应先人工运行一次。若原始项目已经失败,应记录失败输出,避免之后误认为是 Codex 修改造成的问题。

检查登录与网络

首次登录通常需要打开浏览器完成认证,后续模型请求也依赖稳定网络。企业代理、防火墙、TLS 检查和终端代理变量都可能影响连接。

先用浏览器确认能访问 ChatGPT 登录页面,再检查终端是否被错误代理或证书拦截。不要为了排障关闭系统证书验证,也不要把账号令牌、API Key 或代理密码写入仓库。

建立一个安全起点

建议新建练习分支,在小型仓库中完成第一次任务。开始前记录 Git 状态,任务结束后只通过差异和测试判断结果,不把聊天总结当作唯一依据。

如果后续准备使用云端环境,还应确认仓库已托管到可连接的平台,并整理依赖安装、环境变量和初始化步骤;本地未提交文件不会自动成为云端上下文。

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

目录与阅读设置

阅读设置

17

记录一个想法

准备开发环境

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

登录哪都通