← 返回系统教程
系统教程快速开始CLI / IDE / App入门

安装与登录 Codex:macOS、Windows 和 Linux 的可靠路径

按操作系统选择官方安装方式,完成 ChatGPT 登录或 API key 配置,并用版本与最小只读任务验证环境。

25 分钟阅读核验于 2026/07/21

先选择官方安装入口

CLI 可通过官方安装脚本、npm、Homebrew 或 GitHub Release 安装。桌面应用和 IDE 扩展应从 OpenAI 文档指向的入口获取,避免来源不明的安装包。

  • 安装后运行 codex --version。
  • 确认当前终端实际调用的 codex 路径。
  • 企业设备先确认代理与软件安装策略。

完成认证

交互式首次启动优先选择 Sign in with ChatGPT;只有明确需要 API 计费或自动化环境时再使用 API key。不要把 key 写进仓库、截图或任务正文。

做一次最小验证

进入一个测试仓库,让 Codex 只读概括目录和验证命令。确认仓库、权限和网络边界正确后,再开始写入任务。

codex --version
cd /path/to/test-repo
codex

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Codex Quickstart

    官方来源 · https://learn.chatgpt.com/docs/quickstart

  2. OpenAI Codex CLI

    官方来源 · https://learn.chatgpt.com/docs/codex/cli

  3. openai/codex 官方仓库

    官方来源 · https://github.com/openai/codex

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。