AIZX / 实用指南

Codex CLI 中文教程:安装、登录和第一次代码任务

Codex CLI 让你在终端里阅读项目、修改文件和运行已有开发工具。最短的上手路径是:从官方渠道安装,确认认证方式,进入项目目录,再完成一个可以验收的小任务。下面用“找出测试命令并修复一个已知错误”串起整个过程。

本文目录 · 6 个章节

安装与版本确认

已经使用 npm 管理开发工具的用户,可执行官方文档提供的安装命令:

1npm install -g @openai/codex
2codex --version

官方还提供独立安装器和 Homebrew 方式。选择一种符合本机环境的安装方法即可,完整入口见Codex CLI 官方文档。安装遇到权限问题时,应检查自己的包管理环境,不要不加判断地把所有命令改成管理员权限。

登录前分清账单

在终端执行 codex login,按浏览器流程完成登录。想确认当前认证方式,可运行 codex login status。使用 ChatGPT 登录和使用 API Key 计费的归属不同,官方的认证说明列出了适用范围。

不要把 API Key 放进聊天截图或直接写进仓库。组织提供的接入方式也应由管理员确认,避免在不知情时切换到个人付费账户。

在项目目录启动

进入你实际要修改的项目文件夹,执行 codex。第一轮让它找出 README、依赖和测试入口,先确认它理解的是正确项目。一个实用的提示是:

阅读当前项目,找出启动方式和测试命令。解释用户提交表单后会调用哪些文件。先只读,不修改;没有找到的部分明确说明。

如果返回的路径不存在,先纠正上下文。终端运行位置错误时,模型再强也可能读到无关文件。

把需求写成验收条件

第二轮可以这样提出任务:

复现空表单仍被提交的问题。修复后,空输入显示字段提示,合法输入保持原行为;不要改动无关页面。完成后运行相关检查,并列出需要手动验证的条件。

验收时打开代码差异,检查修改范围;在真实页面测试正常输入和错误输入。CLI 说“完成”之后,仍然要确认功能结果,而不只是查看命令退出码。

额度、超时与重置怎么看

使用订阅登录时,可在会话中用 /status 查看当前信息,并结合官方用量面板。官方价格与限制说明强调,用量估计并不是固定消息条数。代码规模、任务长度与模型会影响消耗。

本站重置信号雷达只能整理公开信息,不能查询你的个人额度。API 方式出现连接或响应问题时,可用API 测速对自己填写的兼容接口做小规模排查。

下一步练习

完成一个小修复后,再尝试补充文档、整理测试或阅读陌生模块。不要第一次使用就让助手迁移数据库或重写整个仓库。不同入口的用途见Codex 中文入门,选型比较见Codex 与 Claude Code