灿海星图指南--Codex CLI，94K星终端Agent，ChatGPT账号免费直接用
Codex跟Claude Code最大的差别不在技术——在一个细节：你有ChatGPT Plus账号就能直接用，不用额外掏钱买API额度。对于已经有ChatGPT订阅的人来说，这等于免费的AI编程助手。
本文是一篇实操指南，预计15分钟了解全貌。已核实内容与官方GitHub README一致。
这是什么
Codex CLI是OpenAI的终端编程Agent，94.6K星。Rust编写，启动极快。运行在本地电脑上。
四种使用方式
Codex不只有一个终端版本，它有四个入口：
| 方式 | 命令/入口 | 适用场景 |
|---|---|---|
| CLI | codex | 终端里写代码 |
| IDE 插件 | VS Code / Cursor / Windsurf 装插件 | 代码编辑器里用 |
| Web | chatgpt.com/codex | 浏览器里用，手机也能打开 |
| 桌面 App | codex app | 独立桌面应用 |
手机怎么用：打开浏览器访问chatgpt.com/codex，登录ChatGPT账号。适合在路上让AI帮你读代码、改代码。
四种安装方式
方式一：官方脚本（推荐）
# Mac/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 install --cask codex
方式四：二进制下载
去GitHub Releases页面下载对应平台的二进制文件。
认证：ChatGPT账号免费
运行codex，选**"Sign in with ChatGPT"**。如果你有ChatGPT Plus/Pro/Business/Enterprise账号，直接用——不需要配API Key。
API Key也可以，但需要额外设置。
核心用法
codex # 启动对话
codex "重构这个函数" # 直接执行任务
codex app # 打开桌面应用
Codex vs Claude Code
| 维度 | Codex | Claude Code |
|---|---|---|
| 星数 | 94.6K | 135K |
| 语言 | Rust | Python |
| 启动速度 | 快 | 中等 |
| GPT账号 | 直接登录 | 不支持 |
| 接入灿海星图 | 支持API Key | 支持 |
| 开源协议 | Apache 2.0 | 专有 |
踩坑实录
坑1：ChatGPT账号登录在某些地区需要VPN。 登录过程需要访问OpenAI服务。
坑2：通过API使用时需要配环境变量。 export OPENAI_API_KEY=xxx。
常见疑问
Q1：ChatGPT Free账号能用吗？
官方文档要求Plus/Pro/Business/Enterprise账号。Free账号登录后可能遇到配额不足的提示。如果不想付费升级，可以用API Key方式接入灿海星图或其他兼容端点。
Q2：用API Key和用ChatGPT账号登录功能有区别吗？
API Key模式下模型选择更自由（可以指定gpt-4o、o4-mini等），ChatGPT账号登录由系统自动分配模型。需要精细控制模型和成本的话，API Key模式更合适。
Q3：Rust写的就比Python快很多吗？
启动速度确实更快——Codex几乎秒开。但实际使用时大部分时间在等API响应，语言差异影响不大。频繁开关终端会话时Rust的快启动才有明显感知。
本文数据来源于GitHub仓库（openai/codex）及作者实测。