Codex CLI 快速上手：安装、登录与常用操作

安装

任选一种方式：

# npm
npm install -g @openai/codex

# Homebrew
brew install --cask codex

也可以直接从 GitHub Releases 下载对应平台的二进制文件，提供 macOS（Apple Silicon / Intel）和 Linux（x86_64 / arm64）版本。

登录

在项目目录里运行：

codex

首次启动会让你选择登录方式：

• Sign in with ChatGPT：使用 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 套餐里包含的额度，推荐
• API Key：使用 OpenAI API Key，按用量计费

第一个任务

启动后直接用自然语言描述任务，例如：

阅读这个项目，然后给 utils/date.ts 里的 formatDate 补充单元测试，并运行测试。

Codex 会先规划，再读文件、改代码、执行命令。它在执行有风险的操作前会请求你的确认，具体的审批策略和沙箱范围可以在配置里调整。

其他入口

• 桌面应用：运行 codex app
• IDE 插件：在 VS Code 插件市场搜索 Codex
• 云端任务：访问 chatgpt.com/codex

配置文件

Codex 的用户级配置在 ~/.codex/config.toml，模型、提供方、MCP 服务器等都在这里设置。下一篇「配置自定义模型」会详细介绍。