tidemeet

如何安装并使用 OpenAI Codex CLI：登录与第一次仓库任务

安装 OpenAI Codex CLI，用 ChatGPT 或 API Key 登录，再在真实仓库里跑完第一次任务。

你要的是一个能读本机仓库、改文件、跑本地命令的编程代理，而且整段循环留在终端里。

这篇按官方文档走完 如何安装并使用 OpenAI Codex CLI：安装器、ChatGPT 或 API Key 登录，以及在真实仓库里下发第一次任务。步骤以 developers.openai.com/codex/cli 与 developers.openai.com/codex/auth 为准。

安装 登录 第一次仓库任务

它适合谁、不适合谁

Codex CLI 在本机仓库上工作：查看文件、做修改、跑你已经装好的工具。交互会话用 codex；可重复流水线用 codex exec。它不是网页聊天窗口，也不是必须先装 IDE 扩展。

01

对着真实仓库

先 cd 进项目再启动。官方入门提示是先问 “Tell me about this project”，再做一次可复查的小改动。

02

两种登录，两套账单

ChatGPT 登录走 Plus / Pro / Business / Edu / Enterprise 的套餐额度。API Key 按 OpenAI Platform 价计费，更适合 CI，但依赖工作区的云功能会受限。

03

权限要先设

用 /permissions 看沙箱和可写根目录。官方还建议在任务前后做 Git 检查点，改坏了能回退。

安装、登录、第一次任务

  1. 1

    安装 CLI

    macOS / Linux：curl -fsSL https://chatgpt.com/codex/install.sh | sh。Windows：官方 PowerShell 安装器。也可以 npm install -g @openai/codex 或 brew install --cask codex。同一条安装命令可用来更新。

  2. 2

    登录

    在项目目录运行 codex 或 codex login，选 Sign in with ChatGPT，在浏览器完成授权。无头或本机回调被拦时，用 codex login --device-auth（需在 ChatGPT 安全设置里打开设备码）。自动化：printenv OPENAI_API_KEY | codex login --with-api-key。用 codex login status 核对，codex logout 退出。

  3. 3

    下发第一次仓库任务

    进入仓库，运行 codex。先让它说明项目结构，再要一次聚焦改动，例如补测试或修一个明确的报错。提交前可用 /review。需要团队说明时，可先写 /init 生成 AGENTS.md。

0
额外 IDE 依赖
2
登录方式
1
第一次提示词
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows: irm https://chatgpt.com/codex/install.ps1 | iex
# npm install -g @openai/codex
# brew install --cask codex

codex login
# printenv OPENAI_API_KEY | codex login --with-api-key
# codex login --device-auth

cd ~/code/your-repo
codex
# Tell me about this project

第一次容易卡住的地方

方式 账单 更适合
ChatGPT 登录 套餐额度 本机日常开发
API Key Platform 价 私有 CI / 脚本
设备码 同 ChatGPT 无头或 SSH 主机
把 auth.json 当密码
登录缓存在 ~/.codex/auth.json 或系统钥匙串。不要提交、不要贴进工单。CLI 与 IDE 扩展共用同一份缓存，一边退出另一边也要重登。
无头登录不是同一条浏览器流
远程机拦了 localhost 回调时，优先设备码。备选是在有浏览器的机器登录后安全复制缓存，或把 localhost:1455 经 SSH 转发。
公司代理要带 CA
TLS 代理或私有根证书时，先设置 CODEX_CA_CERTIFICATE 再 codex login。未设置时回退 SSL_CERT_FILE。

官方对 API / CI 的提醒：不要在不信任或公开环境里暴露 Codex 执行。

改完要和人对着看时

代理改完常缺一张图：动了哪些文件、为什么能合。不必再装会议套件。可在tidemeet用浏览器开短时空间，或看如何创建空间。画布用法见共享白板基础。同站关于 OpenAI 评测事故的笔记见METR 调查。

还有疑问？

必须先装 IDE 扩展吗？

不必。CLI 可独立使用。扩展与 CLI 共用登录缓存，但第一次仓库任务只需要终端。

ChatGPT 登录和 API Key 能混用吗？

一次会话只用一种有效登录。ChatGPT 走工作区权限与套餐额度；API Key 走 Platform 组织设置与按量价。Codex cloud 必须用 ChatGPT 登录。

第一次该让它改很大一块吗？

不建议。官方入门是先理解仓库，再做一次聚焦改动。先看 /permissions，并用 Git 检查点保住回退路径。

和临时协作工具有什么关系？

没有产品绑定。只是要对着 diff 讲两句时，临时会议工具对比说明何时用短时浏览器空间即可。

免费创建空间