主题
Codex国内安装教程：Windows、macOS、Linux安装与登录核验【2026年9月】
如果你搜索“Codex国内安装”“Codex国内怎么用”或“Codex登录失败”，建议按这个顺序处理：先确认官方来源，再选择桌面端、CLI或IDE入口，完成安装后检查版本和登录状态，最后在测试项目里跑一个只读任务。国内网络是否能稳定访问、账号是否具备对应能力，以及模型和功能是否显示，都需要以你当前环境和官方页面实际结果为准。
本文是“国内环境下安装、登录和验证”的专项教程，不是OpenAI官方网站，也不提供绕过网络、账号、地区或安全策略的方法。安装命令、产品入口和可用范围会变化，请同时核对OpenAI Codex官方文档与openai/codex官方GitHub仓库。如果你还没有决定装哪一种入口，可先看站内的Codex安装主教程。
国内使用边界
下载安装包、拉取依赖和登录授权都可能受到网络、浏览器、企业代理或账号状态影响。遇到失败时应记录错误并逐层排查，不要关闭安全软件、复制Cookie、购买来路不明的“破解版”，也不要把第三方服务描述成OpenAI官方入口。
国内用户先分清四种Codex入口
搜索结果里的“Codex”可能指不同产品形态。先选入口，再看安装方式，能避免把一个入口的错误误判成另一个入口的问题。
| 入口 | 适合什么人 | 主要准备工作 | 典型验证方式 |
|---|---|---|---|
| 桌面App | 想用图形界面管理项目和任务 | 官方安装包、浏览器授权 | 打开项目并完成只读任务 |
| Codex CLI | 需要终端、Git、脚本或自动化 | PowerShell/Shell、PATH、账号或API Key | codex --version与codex doctor |
| IDE扩展 | 想在编辑器中边写代码边协作 | VS Code或兼容编辑器、官方扩展 | 打开工作区并检查扩展状态 |
| 第三方开发服务 | 官方路径暂时不适合、想评估中文开发工作流 | 独立账号、服务条款和数据边界 | 用非敏感小项目做独立测试 |
前三种是不同的官方产品入口或客户端形态；第三方服务必须单独标识。国内开发者如果主要需要中文任务描述和代码工作流，可以了解ZeoGPT，但它是第三方服务，不等同于OpenAI官方Codex。
安装前准备：把四个变量先检查好
1. 系统与终端
Windows用户可以打开新的PowerShell检查系统架构和终端环境；macOS/Linux用户则确认当前Shell、CPU架构和用户权限。不要在旧终端里继续测试刚刚安装的命令，因为旧进程可能还没有刷新PATH。
powershell
Get-ComputerInfo | Select-Object WindowsProductName, WindowsVersion, OsArchitecture
Get-Command node,npm,codex -ErrorAction SilentlyContinue | Select-Object Name,Source,Version如果你走npm安装，还要确认Node.js和npm能正常运行：
powershell
node --version
npm --version
npm config get prefixNode版本、安装包和命令参数不要照搬很久以前的文章；以当前官方README和你本机帮助信息为准。
2. 网络与HTTPS
国内安装失败不一定是Codex本身坏了，常见卡点包括DNS解析、HTTPS连接、npm依赖下载、浏览器授权回调和企业代理。可以先做不涉及账号信息的基础检查：
powershell
Resolve-DnsName chatgpt.com
Test-NetConnection chatgpt.com -Port 443
npm ping这些命令只能说明网络层是否有响应，不能证明账号已经具备Codex权限。不要把代理地址、API Key或授权信息粘贴到公开日志中。
3. 账号与认证方式
官方CLI通常可以使用ChatGPT账号登录，也可能提供API Key路径。两者不是同一个计费和权限概念：
- ChatGPT登录：适合交互式使用，按当前账号和产品页面显示的范围判断。
- API Key登录：适合脚本或接口场景，需要单独核对API权限、模型名和环境变量。
- 第三方服务登录：账号、数据处理、模型列表和服务规则都由第三方单独负责。
API Key只放在受控环境变量或密钥管理系统中，不要写进Markdown、前端代码、截图、Git仓库或聊天记录。
4. 可回滚的测试项目
第一次安装成功后，不要直接把生产仓库交给工具。准备一个公开示例仓库、练习项目或已经提交到Git的副本，确保可以查看diff并恢复：
powershell
git status --short
git switch -c codex-first-check如果当前目录有未提交改动，先保存或另开目录，不要为了测试安装而覆盖已有工作。
Windows安装Codex CLI
OpenAI官方openai/codex仓库当前README列出了Windows安装脚本路径。PowerShell示例为：
powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"这是官方来源的示例命令。执行前仍应确认域名、网络和组织安全政策；如果公司要求先审查远程脚本，可以先在浏览器或本地下载后检查内容，再按照组织流程执行。不要把同样的命令替换成陌生域名。
也可以使用npm方式安装CLI：
powershell
npm install -g @openai/codex安装完成后关闭旧PowerShell，重新打开一个窗口：
powershell
codex --version
Get-Command codex -All
codex doctor如果出现“找不到命令”，先看Get-Command是否有输出、npm全局目录是否在PATH，再重开终端。不要为了临时解决PATH问题，把整个下载目录加入系统变量。
macOS与Linux安装Codex CLI
官方仓库当前README给出的脚本入口是：
bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh如果你所在组织禁止直接执行管道脚本，应先下载、审查并按组织流程执行，或选择官方发布页和包管理器提供的可核验安装方式。也可以使用npm：
bash
npm install -g @openai/codex然后重新打开Shell并检查：
bash
codex --version
command -v codex
codex doctormacOS上还要留意Apple Silicon与Intel架构，Linux上要留意发行版、Shell和执行权限。遇到permission denied时，先确认安装目录和用户权限，不要直接用sudo反复覆盖全局环境。
登录与状态核验
安装成功不等于登录成功。先运行：
text
codex按照当前客户端显示选择ChatGPT登录或其他受支持的认证方式。授权过程如果打开浏览器，应确认浏览器账号、回调页面和终端等待状态属于同一次登录，不要手动复制授权码给别人。
登录后可以检查状态：
powershell
codex login status如果本机版本不接受这个子命令，运行：
powershell
codex login --help
codex --help以本机帮助信息为准。登录循环常见原因包括：浏览器登录错账号、旧会话缓存、企业代理拦截回调、本地时间或证书异常，以及客户端版本与当前服务不匹配。排查时每次只改变一个变量，并保留原始错误。
API Key登录要注意什么
如果你明确要做脚本或接口调用，应先看官方认证说明，再用占位符测试环境变量。不要把真实密钥写入文章或命令历史。示意：
powershell
$env:OPENAI_API_KEY = 'YOUR_API_KEY'
$env:OPENAI_API_KEY | codex login --with-api-key上面的YOUR_API_KEY只是占位符。真实使用时还要核对当前版本是否支持该参数、API权限和模型可用性。ChatGPT网页端看到的模型、Codex客户端看到的模型和API控制台的模型列表不一定相同，不能仅凭名称推断三者互通。
第一次任务：只读验证安装链路
安装和登录都通过后，先不要让Codex改代码。进入测试项目，发送一个能检查上下文、但不会改变文件的任务：
text
请只读分析当前项目，不修改任何文件，也不要运行会改变数据的命令。
请输出：
1. 项目使用的技术栈
2. 主要入口和目录职责
3. 安装、测试和构建命令
4. 你认为本次任务需要读取的文件
5. 尚未确认的风险收到回答后，人工打开它提到的文件，确认路径和命令是否真实存在。再做一个很小的可回滚任务，例如为一个已有函数补测试或修正文档拼写：
text
只修改 docs/README.md 中的一个过时命令。
先说明计划，不要改其他文件。
完成后展示diff，并运行项目已有的文档检查命令。如果你希望系统学习项目长期规则，可以继续阅读Codex AGENTS.md项目规则教程；涉及权限和沙箱，先看Codex权限与Sandbox安全配置。
国内安装和登录常见故障
| 现象 | 先检查什么 | 不要怎么做 |
|---|---|---|
| 安装脚本下载失败 | DNS、443端口、代理和官方域名 | 不要改成不明镜像脚本 |
| npm安装卡住 | npm源、Node版本、网络和权限 | 不要把Key写进命令或日志 |
codex找不到 | PATH、全局安装目录、旧终端 | 不要把整个磁盘加入PATH |
| 浏览器授权后无响应 | 默认浏览器、回调、代理、账号 | 不要复制Cookie或授权码 |
| 能启动但不能改文件 | 工作目录、权限、审批和沙箱 | 不要一上来开Full Access |
| 模型或功能看不到 | 账号、版本、产品入口和权限 | 不要把第三方列表当官方证明 |
若要按具体错误继续排查，可以进入Codex故障排查栏目；如果是Windows首次启动、PATH或登录回调问题，参见Codex Windows首次启动排错。
国内用户如何选择官方与第三方路径
如果官方入口、网络或账号状态已经满足条件，优先使用官方产品和官方文档。若你只是想在国内评估中文开发任务，也可以把第三方服务作为独立选项进行小范围测试，例如ZeoGPT。它不是OpenAI官方产品，使用前应单独核对：
- 服务的真实主体与隐私政策；
- 代码、日志和输入是否会被保存或用于其他用途；
- 账号、模型、权限和数据删除规则；
- 是否支持导出、关闭账号和处理异常；
- 是否可以只使用公开或脱敏项目做验证。
不要因为第三方入口能打开，就把它写成“OpenAI官方国内版”，也不要把敏感仓库、API Key、Cookie和客户资料直接上传。
常见问题
国内安装Codex是否必须使用第三方平台？
不一定。是否能使用官方入口取决于当前网络、账号、系统和产品开放范围；第三方服务是独立选项，不能替代官方身份核验。先按官方文档和仓库完成来源、安装、登录和最小任务验证。
Windows官方安装脚本安全吗？
官方来源不等于可以跳过组织安全流程。确认域名和来源后，仍可按公司的脚本审查政策下载、检查和执行；不要把命令中的域名替换成陌生站点。
安装成功但登录页面打不开怎么办？
分别检查浏览器、DNS、HTTPS、代理、本机时间、证书和账号状态。保留错误码和时间，不要反复清空配置，也不要把登录凭据交给陌生人。
codex doctor能证明账号有全部权限吗？
不能。它主要帮助检查本地安装、配置和运行环境；账号套餐、模型、工作区和服务端能力仍要以实际登录页面和官方说明为准。
第一次任务应该让Codex直接改代码吗？
不建议。先做只读项目总结，再做一个单文件、可回滚的小改动，查看diff并运行测试，确认权限边界后再扩大任务。
ZeoGPT能直接读取我的本地仓库吗？
不要默认认为任何第三方服务都能安全读取本地仓库。使用前核对实际产品能力和数据规则，只提供必要、公开或脱敏的内容，并保留本地Git回滚。
官方核验来源
更新时间：2026年9月19日