一句话结论:Codex 本身免费,装它只需要两步——先装 Node.js(相当于给电脑装个”引擎”),再用 npm 一条命令安装。真正卡住新手的不是安装,而是Node 版本不对、网络连不上、账号登录失败这三件事。跟着本文一步步来,20 分钟你能跑起来,后面附的排错清单能救你 90% 的急。
我是辉哥,做 IT 产品评测 25 年了。最近后台全是同一个问题:“辉哥,我看到别人用 Codex 一键帮电脑写代码,我也想试,可一装就报错,怎么办?” 说实话,Codex 这东西本身不难,难的是新手第一步就被 Node.js 和登录挡住了。今天这篇,我就当坐在你对面,手把手带你把它装起来、用起来。
一、先搞懂:Codex 到底是啥?
别被”Codex”这个名字唬住。打个比方:你请了个 24 小时在线的程序员实习生,你把需求用大白话告诉他,他就能帮你写代码、改 bug、跑测试。它就是 OpenAI 官方出的命令行编程助手,装在你自己电脑上,免费额度够用,想多用就充点钱。

关键好处有三个:一是数据在你本地,代码不外泄;二是免费额度,日常玩足够;三是能直接操作你的文件,不像有些 AI 只能在对话框里聊天。
二、动手前,先确认你的”地基”
装任何编程工具,第一件事不是装工具,而是看地基稳不稳。Codex 跑在 Node.js 上,Node.js 就像汽车的引擎,没引擎再好的车也跑不起来。
第一步:检查并安装 Node.js
先按 Win + R,输入 cmd 回车,打开黑色命令窗口,输入下面这行看版本:
node -v
如果显示的是 v22.x 或 v24.x,恭喜,地基合格,跳到下一步。如果显示版本号很低、或者提示”不是内部命令”,说明你没装或装旧了。
怎么办:打开 Node.js 官网 (nodejs.org),下”Latest LTS”那个版本(LTS 就是长期稳定版,给新手的最省心)。双击安装,一路点”Next”,勾上那个默认选项就行。装完务必关掉刚才那个黑窗口,重新开一个新窗口——很多人卡在这,就是旧窗口没刷新,认不到新装的引擎。
三、正式安装:三条命令搞定
地基打好,接下来就是装 Codex 本体。npm 是 Node 自带的”应用商店”,一条命令就能把 Codex 装进电脑。
第二步:用 npm 安装 Codex
npm install -g @openai/codex
中间那个 -g 是”全局安装”的意思,装一次,以后所有项目都能用。看到屏幕上刷出一堆下载进度、最后停在 added ... packages,就成了。
第三步:验证装好没
codex –version
能刷出版本号(比如 codex 0.x.x),说明安装成功。
四、登录:这是新手最容易翻车的地方
装好了不等于能用,还得”刷脸进门”。输入下面命令:

codex login
它会弹出一个网址,让你在浏览器里打开,登录你的 OpenAI 账号并授权。注意:命令行窗口别关,等浏览器授权完,命令窗口会自动显示”登录成功”。
到这里,恭喜!你已经是个”会用 Codex”的人了。试着输入一句需求,比如让我帮你写个算斐波那契数列的脚本,它就开始干了。
五、常见问题:我帮你把坑都踩了一遍
下面这些是我实测下来,新手几乎必遇的坑,按顺序排查基本都能解决。
❓ 问题 1:npm 一直转圈、下载不动
这是网络问题,国内连 npm 官方服务器经常龟速。解决办法是换个”近超市”——配置国内镜像:
npm config set registry https://registry.npmjs.cn
换个超市下载,速度快好几倍。
❓ 问题 2:提示 “EACCES permission denied”
意思是没权限装到系统目录。Windows 上简单:右键命令窗口,选“以管理员身份运行”再装一次就行。
❓ 问题 3:登录成功但用不了 / 报额度错误
免费账号有额度限制,且不绑卡可能受限。去 OpenAI 后台确认账号状态正常。真要用得狠,充个 $5 的额度基本够新手折腾几周,别一上来就想买月付套餐。
❓ 问题 4:装了 codex,敲命令没反应
多半是环境变量没刷新。关掉所有黑窗口,重开一个,再试 codex --version。还不行就去 Node.js 的安装目录看看,把 node 和 npm 加进系统 PATH。
六、值不值得装?数据说话
我拿它跟市面上几个常见编程助手横向比过,结论放这:
| 对比项 | Codex CLI | 网页版 ChatGPT | 其他付费编程助手 |
|---|---|---|---|
| 数据是否落地本地 | ✅ 是 | ❌ 否 | 部分支持 |
| 免费额度 | ✅ 有 | 有限 | ❌ 基本收费 |
| 上手难度 | 中(要命令行) | 极易 | 中 |
| 适合人群 | 想练真本事的人 | 纯小白尝鲜 | 专业团队 |
我的建议很实在:想认真学编程、又想省钱,就上 Codex CLI;只是好奇、不想碰命令行,网页版聊两句也行,但别指望它帮你干活。
七、优点和缺点,我一次说清楚
- 数据全程在本地,隐私放心
- 有免费额度,新手零成本试水
- 能直接读写你电脑里的文件,是真干活
- 开源社区活跃,更新快
- 要敲命令行,纯小白有学习门槛
- 国内装 Node 和 npm 要折腾网络
- 重度使用要充钱,免费额度有限
- 出错时报错信息偏技术,新手看不懂
八、辉哥的掏心窝子话
折腾完你会发现,Codex 最大的价值不是”帮你写代码”,而是逼你把编程的逻辑想明白。你连需求都描述不清楚,它就帮你写不出来。工具再聪明,也得有个”会说话”的主人。
所以我给新手的忠告是:先学会用大白话把需求讲清楚,再让 Codex 帮你实现。这个能力,就算哪天 Codex 不火了,也照样用得上。
总评
Codex CLI 是新手入门”真·编程助手”的高性价比之选。
上手难度 ★★★☆☆|性价比 ★★★★★|隐私安全性 ★★★★★
一句话:装好 Node、换镜像、耐心登录,20 分钟你也能用上。
作者简介
辉哥,25 年 IT 老兵,一线产品评测人。做过开发、带过团队、评测过上千款软硬件工具。信奉”不说废话,只上干货”,擅长把复杂的技术问题用大白话讲明白。写文章的原则很简单:让你花最少的时间,做最对的判断。