wbmeet

如何安装并使用 OpenAI Codex CLI：终端安装、登录与 Git 仓库首个编码任务

官方安装、ChatGPT 登录或 API Key，再在仓库里做第一个可审查 diff。

第一次在终端里跑 OpenAI Codex CLI，卡住的通常不是提示词，而是装到哪个包、codex 有没有在 PATH 里，以及 ChatGPT 账号登录或 API 计费路径没选对。按 OpenAI 官方文档装完、登录，再在你自己的 Git 仓库里做一件能审查的事。

检索词是 如何安装并使用 OpenAI Codex CLI。下文对照 developers.openai.com/codex/cli 与 ChatGPT Learn 的 CLI 入门（learn.chatgpt.com/docs/codex/cli）。这是本地终端代理，不是浏览器里的 chatgpt.com/codex 云端 Codex，也不是 IDE 插件。要约短会对齐 diff，用 wbmeet 建房即可，步骤见 如何创建与加入房间。

安装 codex登录仓库里的第一件事

先核对你要的是哪条 Codex

OpenAI 现在有多条「Codex」产品线：终端里的 Codex CLI（本页）、编辑器里的 Codex 扩展、桌面 codex app、以及网页 chatgpt.com/codex。本页只写 CLI：在项目目录执行 codex，它会读文件、改代码、跑本地命令（具体权限以会话设置为准）。

CLI
本地终端代理
npm
或 install.sh
1 次
浏览器登录（推荐）

第一次：安装、登录、改一行能审查的代码

  1. 1

    用官方通道安装

    macOS / Linux 脚本（OpenAI 文档推荐之一）：curl -fsSL https://chatgpt.com/codex/install.sh | sh。全平台也可用 npm：npm install -g @openai/codex（需已安装 Node.js）。Windows 或受限环境可到 OpenAI Codex 的 GitHub Release 下载对应平台二进制，细节以 developers.openai.com/codex/cli 为准。装完新开终端，跑 codex --version 或 which codex。

  2. 2

    在项目目录启动并登录

    cd 到你拥有的 Git 仓库，执行 codex。首次运行按提示选择 Sign in with ChatGPT，用 Plus、Pro、Business、Edu 或 Enterprise 等官方套餐账号完成浏览器认证（以 OpenAI 当前说明为准）。若走 API 计费，在 platform.openai.com 创建密钥，导出 OPENAI_API_KEY 后再启动；不要把密钥写进仓库或提交到 Git。

  3. 3

    确认权限模式再下指令

    CLI 会询问或展示它能否读文件、执行 shell 命令。第一次建议用保守模式：允许读仓库，执行命令前先看 diff 或确认提示。阅读官方文档里关于 sandbox / approval 的说明（名称以当前版本为准），企业环境先问 IT 是否允许把代码上下文发到 OpenAI。

  4. 4

    做一个能审查的第一任务

    先问：「这个项目做什么？入口文件在哪？」再下一条具体指令：「给一个没测试的辅助函数补单测，或给一个对外函数加输入校验。先出示 diff，等我同意再写入。」完成后用 git diff 自己再过一遍，再决定是否提交。不要把生产密钥、客户数据或 .env 内容贴进提示。

# First hour · OpenAI Codex CLI · 2026-10
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# or: npm install -g @openai/codex
codex --version
cd /path/to/your/git/repo
codex
# Sign in with ChatGPT (browser)
# first task:
# 1) what does this repo do and where is the entry point?
# 2) add a unit test for one helper; show diff before applying

登录路径、安装方式、常见坑

路径官方怎么写第一次注意
Sign in with ChatGPTPlus / Pro / Business 等套餐推荐个人开发者
OPENAI_API_KEYplatform.openai.com 自建密钥按 API 用量计费；别提交密钥
install.shmacOS / Linux 一键脚本新开终端再跑 codex
npm @openai/codex全平台全局安装确认 Node 与 PATH
chatgpt.com/codex云端 Codex Web不是本页 CLI
01

装完 command not found

多半是 PATH。关闭旧终端窗口，新开一个。npm 全局包常见目录需加入 PATH（如 ~/.npm-global/bin 或 nvm 的 shims）。仍失败就对照官方 CLI 页的 Troubleshooting。

02

和 Copilot / Claude Code 混用

可以同时装多个终端代理，但一次只在一个目录开一个代理会话，避免互相改同一文件。对比见站内 Copilot CLI 与 Claude Code 笔记。

03

第一任务停在闲聊

「这个仓库做什么」只是热身。要有一条可审查的改动：单测、校验或你点名的小 bug，并自己跑测试或 linter。

官方建议：在项目目录运行 codex，用 ChatGPT 账号登录后完成第一个真实编码任务。命令、套餐包含项与区域限制以 developers.openai.com 与 ChatGPT 账号页为准。

CLI ≠ IDE 里的 Codex
要在 VS Code / Cursor 里用，需按官方说明单独装编辑器扩展；本页只覆盖终端 codex 命令。
CLI ≠ Codex Web
浏览器云端代理在 chatgpt.com/codex；终端 CLI 在本地仓库里工作，两者账号体系相关但入口不同。
教程页不是会议说明书
只讲 Codex CLI 第一次。短会白板见 wbmeet，以及 Cursor CLI 等并行工具的对照。

还想核对的问题

没有 ChatGPT 付费套餐还能用 Codex CLI 吗？

官方文档写可用 ChatGPT 账号登录（套餐包含项以 OpenAI 说明为准），也可用 API Key 路径并按 API 计费。免费档是否包含 Codex 以当前 ChatGPT 计划页为准，不要用过审共享账号。

npm 和 install.sh 该选哪个？

都能装到 codex 命令。已有 Node 且习惯 npm 用 npm install -g @openai/codex；macOS/Linux 想少依赖 Node 可优先官方 install.sh。版本以 codex --version 为准。

API Key 和 ChatGPT 登录有什么区别？

ChatGPT 登录走订阅套餐额度；API Key 走 OpenAI Platform 计费与配额。企业常走 API + 组织策略。密钥只放环境变量或密钥管理器，不要进 Git。

第一个任务必须自动提交 Git 吗？

不必。官方流程允许你先看 diff 再决定是否应用。第一次建议只改可回滚文件、自己跑测试，再 git commit。

免费开始开会