Codex 安装与入门：完成第一个项目任务

Codex 安装完成后的第一步，不是立刻让它重写整个项目，而是确认客户端、仓库和权限都符合预期。本教程沿用历史资料中的“先调查、再改动、后验证”流程，帮助你完成一次范围清晰的小任务。

一、选择 Codex 使用入口

前往 Codex 官方快速入门查看当前支持的客户端。喜欢图形界面的用户可以选择官方桌面应用；常驻编辑器的用户可以查看 IDE 扩展；熟悉终端的用户可以使用 CLI。

客户端的系统要求、下载入口与账号支持范围可能更新，应以官方页面和登录界面为准。本文不固定安装包直链，不要求先购买特定套餐。

二、完成 Codex 安装与登录

桌面应用请从官方产品页进入下载，根据系统与芯片选择安装包，按安装向导操作。IDE 扩展请从官方文档指向的扩展页面安装，并核对发布者。

如果选择 npm 安装 CLI，常用命令为：

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

安装前先按当前官方说明准备受支持的 Node.js 环境。若全局安装报权限错误，检查 Node.js 的安装方式与目录权限，不要直接复制来源不明的提权脚本。

启动后按客户端提示完成登录。账号登录与 API 凭据是不同的鉴权方式，实际可用方式和计费规则需要查阅官方说明；不要把密钥粘贴到任务对话或提交到 Git。

三、打开一个练习项目

选择已有的小型 Git 仓库，而不是整个个人文件夹。开始前在终端检查：

git status --short
git branch --show-current

确认当前目录、分支和未提交改动，保留自己已有的工作。桌面应用中打开仓库根目录；CLI 用户在该目录运行 codex。

四、先做一次只读调查

可以直接使用这条请求：

阅读当前项目的 README 和主要配置文件。
告诉我项目如何启动、如何运行测试，以及核心代码在哪里。
先不要修改任何文件，也不要安装依赖。

检查它是否引用了真实存在的目录和脚本。如果项目没有某种测试，不应接受凭空生成的测试命令。缺少信息时，先补充背景再继续。

五、完成一个小范围改动

选择一个真实存在的函数或页面，例如：

为项目中的日期格式化函数补充无效输入处理。
先阅读现有实现与测试，沿用项目风格，只修改相关文件。
完成后运行对应测试，说明具体改动和未验证的部分。

示例中的功能需要替换成你项目中实际存在的目标。批准文件操作或命令前，确认路径与任务范围一致，详见 Codex 权限与安全边界。

六、验证 Codex 的交付

查看客户端的差异界面，或运行 git diff。检查是否包含无关文件，测试是否实际执行，失败是否被如实说明。需要复查测试过程时，要求列出命令和输出摘要。

首个任务完成后，再逐步增加复杂度。长期规则可以写进 AGENTS.md，一次任务的限制保留在提示词里。

常见问题

安装完成但命令找不到怎么办？

重启终端，检查 npm 全局可执行目录是否在 PATH 中，再核对所使用的 Node.js 环境。不要反复安装多个版本而不检查路径。

能登录就代表所有功能都可用吗？

不代表。功能还可能受客户端版本、账号和组织策略影响；具体问题见 Codex 常见问题排查。

完成 Codex 安装与第一项任务后，继续学习 CLI 工作流或 任务提示词。