乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > 保姆级教程|OpenAI Codex 安装+配置(npm 版),小白也能一次成功

保姆级教程|OpenAI Codex 安装+配置(npm 版),小白也能一次成功

当前时间： 2026-08-10 08:26:39 分类：办公文件 评论(0)
保姆级教程|OpenAI Codex 安装+配置(npm 版),小白也能一次成功

经常用代码辅助工具的小伙伴，今天给大家带来 OpenAI Codex 完整安装+配置教程，全程无复杂操作，小白跟着走就能搞定，原生终端代码AI能力直接拉满✨

先划重点：全程无需 API Key、仅用 codex login 账号登录、npm 一键安装、适配 macOS、Linux、WSL、Windows 全系统，步骤清晰，避坑指南全部整理完毕，建议收藏备用，安装时直接对照操作～

一、必装前置依赖（缺一不可！）

很多小伙伴安装后启动失败、命令无法识别，大概率是漏了这一步，先把基础依赖装到位，后续操作一路顺畅👇

全系统必装：Node.js（自带 npm 核心环境）

Codex CLI 官方工具基于 Node.js，没有它，输入 npm 命令会直接报错，无法启动！

✅ 推荐版本：Node.js LTS 长期稳定版（v18+ 及以上），兼容性最好，无需额外折腾
👉 下载地址：https://nodejs.org/zh-cn/download（官网直接下载，安装全程下一步）

⚠️ Windows 安装关键：务必勾选 Add Node.js to PATH，自动配置系统环境变量，否则终端识别不到命令！

✅ 安装验证：安装完成后，打开终端（macOS/Linux）或 PowerShell（Windows），输入以下两个命令，能正常显示版本号即安装成功：

node -v
npm -v

二、npm 安装 Codex CLI（复制命令即可）

前置依赖全部装完，直接复制对应系统命令，粘贴到终端/ PowerShell 执行，等待自动全局安装完成即可。

1. Windows 系统

右键 PowerShell → 以管理员身份运行，复制以下命令粘贴回车，官方全局安装：

npm install -g @openai/codex

国内网络下载慢，可使用淘宝镜像加速安装：

npm install -g @openai/codex --registry=https://registry.npmmirror.com

2. macOS / Linux / WSL 系统

打开终端，复制以下命令粘贴回车即可：

npm install -g @openai/codex

若提示权限不足，命令前加 sudo：

sudo npm install -g @openai/codex

3. 验证安装是否成功

终端直接输入：

codex -V

出现版本号信息，就代表 Codex CLI 本体安装全部成功。

三、账号登录授权（核心！全程无需 API Key）

本教程全程不需要申请、填写任何 OpenAI API Key（sk-密钥），仅使用官方 codex login 浏览器 OAuth 授权登录，自动获取并永久保存登录凭证，一次登录永久生效。

  1. 1. 保持纯净美国节点全局网络（必须可正常访问 openai.com 官方域名），终端直接输入登录命令：
codex login
  1. 2. 命令执行后，工具自动唤起系统默认浏览器，跳转 OpenAI 官方账号授权页面；
  2. 3. 在浏览器页面，登录你的 ChatGPT / OpenAI 账号（需拥有 Plus/Pro 订阅权限即可解锁完整 Codex 代码模型权限）；
  3. 4. 完成 Cloudflare 人机验证，点击 Allow 允许全部授权；
  4. 5. 授权完成后，页面自动提示登录成功，终端会同步打印登录成功日志；
  5. 6. 工具自动把登录 Token 加密保存在本地配置目录 ~/.codex/，后续重启终端无需重复登录。

四、启动 Codex，开始使用代码AI能力

所有配置、登录全部完成后，按照以下步骤启动，即可正常调用原生 OpenAI Codex 代码大模型，完成代码编写、补全、调试、脚本生成全能力。

  1. 1. 打开终端/ PowerShell，进入你的项目工作目录（cd 切换到本地代码文件夹）；
  2. 2. 直接输入命令启动 Codex 交互终端：
codex
  1. 3. 首次启动会提示信任当前文件夹权限，输入 y 回车确认，允许工具读写本地项目文件；
  2. 4. 授权信任完成，即可直接在交互界面输入需求，Codex 自动生成、修改、优化代码。

五、常见问题避坑指南

整理了安装登录全程高频问题，提前规避，少走弯路👇

  • • 问题1：输入 codex 命令报错 command not found
    解决：Node.js 未勾选添加到系统 PATH，或安装后未重启终端；重启终端重试，仍报错则重装 Node.js LTS 版本。
  • • 问题2：codex login 执行后浏览器无法打开授权页
    解决：网络环境非美国纯净全局代理，仅浏览器挂代理无效，需系统全局网络，切换合规节点重试。
  • • 问题3：登录提示 No Active Subscription 无使用权限
    解决：登录的 OpenAI 账号未开通 ChatGPT Plus/Pro 订阅，Codex CLI 网页登录权限仅对订阅账号开放。
  • • 问题4：npm 安装报错权限不足
    解决：Windows 以管理员身份运行 PowerShell；macOS/Linux 安装命令前添加 sudo 执行。
  • • 问题5：重复打开终端需要重新登录
    解决：本地 .codex 登录缓存文件夹被删除，重新执行 codex login 授权一次即可。

到这里，OpenAI Codex（npm 原版、无 Key 登录版）安装+配置+登录使用 就全部完成啦！全程无密钥配置、无复杂环境、小白跟着步骤一次成功，终端代码开发效率直接翻倍～

操作过程遇到登录、命令报错问题，都可以对照排查解决，赶紧上手体验最强原生代码大模型吧🚀