Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

快速上手:安装、登录与第一个任务

用安装脚本、npm 或 Homebrew 安装 Codex CLI,用 ChatGPT 账号或 API Key 登录,在项目目录里开始第一个任务。

安装 Codex CLI

任选一种方式。

macOS / Linux(独立安装脚本,更新时重新运行同一条命令):

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows(PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm:

npm install -g @openai/codex

Homebrew(更新用 brew upgrade --cask codex):

brew install --cask codex

在 Windows 上也可以在 WSL2 里运行 Codex,见「Windows 与 WSL」页。

登录

在项目目录里运行 codex。第一次运行时选择 Sign in with ChatGPT 或其他可用的登录方式,浏览器完成授权后凭据会回到 Codex。也可以单独运行:

codex login

要用 API Key(按 OpenAI Platform 账号的标准 API 价格计费),把 Key 通过标准输入传给 codex login:

printenv OPENAI_API_KEY | codex login --with-api-key

codex login status 查看当前的认证方式。更多登录细节见「认证」页。

第一个任务

登录后直接用自然语言描述任务,例如让 Codex 先解释项目,再做一个聚焦的改动:

Tell me about this project

官方建议在任务前后各做一次 Git 检查点(提交),这样出问题时可以回退。

接下来