安装与版本确认
已经使用 npm 管理开发工具的用户,可执行官方文档提供的安装命令:
1npm install -g @openai/codex2codex --version
官方还提供独立安装器和 Homebrew 方式。选择一种符合本机环境的安装方法即可,完整入口见Codex CLI 官方文档。安装遇到权限问题时,应检查自己的包管理环境,不要不加判断地把所有命令改成管理员权限。
登录前分清账单
在终端执行 codex login,按浏览器流程完成登录。想确认当前认证方式,可运行 codex login status。使用 ChatGPT 登录和使用 API Key 计费的归属不同,官方的认证说明列出了适用范围。
不要把 API Key 放进聊天截图或直接写进仓库。组织提供的接入方式也应由管理员确认,避免在不知情时切换到个人付费账户。
在项目目录启动
进入你实际要修改的项目文件夹,执行 codex。第一轮让它找出 README、依赖和测试入口,先确认它理解的是正确项目。一个实用的提示是:
阅读当前项目,找出启动方式和测试命令。解释用户提交表单后会调用哪些文件。先只读,不修改;没有找到的部分明确说明。
如果返回的路径不存在,先纠正上下文。终端运行位置错误时,模型再强也可能读到无关文件。
把需求写成验收条件
第二轮可以这样提出任务:
复现空表单仍被提交的问题。修复后,空输入显示字段提示,合法输入保持原行为;不要改动无关页面。完成后运行相关检查,并列出需要手动验证的条件。
验收时打开代码差异,检查修改范围;在真实页面测试正常输入和错误输入。CLI 说“完成”之后,仍然要确认功能结果,而不只是查看命令退出码。
额度、超时与重置怎么看
使用订阅登录时,可在会话中用 /status 查看当前信息,并结合官方用量面板。官方价格与限制说明强调,用量估计并不是固定消息条数。代码规模、任务长度与模型会影响消耗。
本站重置信号雷达只能整理公开信息,不能查询你的个人额度。API 方式出现连接或响应问题时,可用API 测速对自己填写的兼容接口做小规模排查。
下一步练习
完成一个小修复后,再尝试补充文档、整理测试或阅读陌生模块。不要第一次使用就让助手迁移数据库或重写整个仓库。不同入口的用途见Codex 中文入门,选型比较见Codex 与 Claude Code。