ARTICLE · 1236495
Codex 安装与配置指南:如何在你的电脑里安装codex
第一次装 Codex，最容易卡住的并不是“不会写代码”，而是几个小问题叠在一起：该装桌面端还是终端版？Windows 要不要 WSL？登录后为什么没有模型？配置文件到底能不能改？ 这篇不讲玄学，按“选入口 → 安装验证 → 连接模型 → 安全使用 → 排错”的顺序，把新手真正需要知道的事讲清楚。 |
先纠正一个容易被误解的说法：Codex 可以在你的本机项目与工具环境中工作，例如读取你授权的文件、运行受控命令、修改代码并做验证；但模型服务是否在本机运行，取决于你选择的登录方式或模型提供商。“本机工作区”不等于“所有模型推理都在电脑本地完成”。
01装之前，先选对入口
Codex 常见有两条使用路径：桌面端适合想直接开项目、用图形界面聊天与查看文件的人；CLI（终端版）适合需要在项目目录里运行命令、做自动化或喜欢终端工作流的人。新手不用两个都装。先从你最舒服的一条开始即可。
原来很多教程会写“Windows 必须先装 WSL2”。这不是适用于所有人的硬规则：当前官方材料已覆盖 Windows 与 PowerShell 场景。若你的团队脚本依赖 Linux 命令、容器或固定的 Unix 路径，WSL 会更顺手；若只是使用桌面端或原生终端，不必为了“跟教程一致”先多装一层环境。
02电脑要准备什么？别只盯着内存
不同版本、不同入口的具体要求会更新，所以不建议把某个“最低 4G、建议 8G”当成永久标准。实际安装前，先检查下面这张清单；它比死记硬背一个数字更有用。
| 安装前 5 项检查 1）系统已更新到仍受支持的版本；2）网络稳定，能完成登录与访问模型服务；3）如果装 CLI，已准备好 Node.js／npm 或你要用的包管理方式；4）有一个不重要的测试文件夹；5）知道项目资料和密钥不能随便上传、贴到聊天或截图里。 小提醒：真正影响体验的常常是同时开了多少 IDE、浏览器标签和本地服务。机器空间紧张或内存长期吃满时，先清理后台，比盲目重装更有效。 |
03开始安装：先让命令跑起来，再谈高级配置
如果选择 CLI，官方材料中可核对的安装方式包括 npm。打开终端后执行：
codex --version
第一行负责安装或更新；第二行只做验证。只要能看到版本号，就说明终端已经找得到 Codex。若你本来通过 Homebrew 安装，则按自己现有的安装渠道更新，不要又混着 npm 重装；官方示例中 Homebrew 的更新方式是：
brew upgrade --cask codex
codex --version
不要急着用管理员权限或 sudo。如果安装完提示“找不到 codex”，先关闭并重新打开终端，再执行codex --version；仍找不到时，再检查 npm 的全局安装路径是否已经加入系统 PATH。Windows 可用Get-Command codex，macOS／Linux 可用which codex来定位。 |
装好以后，先运行codex，按界面的指引登录；再运行一次codex --help，确认你安装的版本提供哪些命令。桌面端则通过官方桌面应用进入 Codex，不需要为了“像教程一样”再去猜一个桌面启动命令。
04模型怎么接？从省心方案开始
对新手来说，模型接入有三种难度，不要一上来就碰最难的那一种。
选择 ChatGPT 登录时，以当前界面的资格提示为准，不要把旧教程里某个套餐名称当作永久规则。选择 API 时，密钥应该只存在于你受控的环境变量或团队密钥管理工具中；不要把密钥写进项目代码、截图、聊天记录或公开配置仓库。
| 关于 config.toml，先记住这 5 件事 ① 常见用户级配置位于~/.codex/config.toml；若使用 WSL，这个“~”指 Linux 主目录，不是 Windows C 盘。② 模型名必须与服务商文档完全一致。③ 提供商名称、服务地址和接口格式必须成套匹配。④ 某些服务使用 Responses 格式，另一些使用兼容接口，不能靠“两个都试试”来碰运气。⑤ 密钥优先放环境变量，不要直接写入配置文件。 |
第三方兼容服务最常见的报错，通常来自模型名、接口地址、鉴权方式或协议不匹配。正确排查顺序是：先验证该服务自身的接口文档 → 再确认 Codex 当前版本支持的提供商配置 → 最后做一次最小请求。不要复制陌生人配置里的地址、令牌或wire_api值。
05第一次使用，先在“安全的小项目”里试
第一次打开 Codex，不要直接把它放进公司的正式仓库，也不要一上来就允许它运行所有命令。更稳妥的做法，是建一个测试文件夹，放一两个无关紧要的文本或小示例，让它完成一次完整但低风险的流程。
不要修改任何文件，也不要执行联网、安装或删除命令。
等我确认后，再提出一个可撤销的小改动建议。
这三句话能帮你观察它如何阅读上下文、如何说明计划、如何请求权限。确定你理解每个动作后，再逐步扩大它能接触的目录与可执行的任务范围。
新手的三条红线：不在不信任的目录里执行自动化操作；不把密钥、Cookie、客户数据贴到提示词里；遇到“删除、覆盖、推送、联网下载、改权限”类动作，先读清楚再确认。安全限制不是阻碍，它是在给你留最后一次判断机会。 |
06常见问题：别反复重装，先定位哪一环断了
✓最后给新手的一句话
安装工具只是开始。真正拉开差距的，是你能不能把任务说清楚、把权限边界设清楚、把每一次成功配置沉淀下来。先把“安装成功、能登录、能在测试目录完成一次小任务”这三件事做好，后面的模型接入、Skill 和自动化才有稳定的地基。 |
安装与更新命令参考：OpenAI Developers｜Using Goals in Codex。
关于本地工作流、权限与应用边界：OpenAI Developers｜Codex as a platform。实际功能、资格与配置项以安装版本中的帮助与官方文档为准。
