前置条件
- 1已安装 Node.js 18+（npm 安装方式）或可运行官方安装脚本
- 2已注册 OpenAI 账号并拥有 ChatGPT 订阅或 OpenAI API Key
- 3支持 macOS 12+ / Linux / Windows（推荐 WSL2）
腾讯智能体开发平台 ADP
新客首月专属价，最高直降 880 元，构建/分发/治理企业级 Agent
常见问题
QCodex CLI 和 ChatGPT 网页版有什么区别？
Codex CLI 是运行在终端里的编程 Agent，可以直接读写本地文件、执行 Shell 命令、跑测试，受沙箱保护；ChatGPT 网页版只能对话。两者可共用同一个 ChatGPT 订阅额度。
Q必须有 ChatGPT 订阅才能用吗？
不是。用 `codex login --with-api-key` 走 OpenAI API Key 按量计费也可以，适合 CI/CD 等编程化场景；订阅用户则用 `codex login` 走 OAuth，无额外按量计费。
Q国内网络无法完成 `codex login` 怎么办？
OAuth 回调需要连接 OpenAI 服务器。可改用 API Key 方式，或把本地 `~/.codex/auth.json` 复制到远程机器，也可在 `config.toml` 中配置 OpenAI 兼容的第三方端点。
Q如何切换到其他模型供应商？
用 `--provider` 标志，内置支持 openai（默认）、openrouter、gemini、ollama、mistral、deepseek、xai、groq；或在 `~/.codex/config.toml` 中通过 `model_provider` 配置。
QWindows 原生支持吗？
支持 npm 与二进制安装，但 macOS 12+ 才有 Apple Seatbelt 沙箱；Linux 推荐用 Docker 做沙箱；Windows 建议使用 WSL2 获得更完整体验。
QFull Auto 模式安全吗？
Full Auto 下每条命令都在禁网、目录沙箱内执行，写入仅限当前工作目录与临时文件。若目录未纳入 Git，启动时会有警告提示，建议始终在 Git 仓库内使用。