大家好我是 Codex 中文网的站长宇哥。最近很多朋友都在问我Codex 到底怎么安装Windows 能不能用Mac 怎么装Linux 服务器上能不能跑我的建议是如果你平时经常写代码、改项目、看源码Codex 真的值得装一下。它不是单纯的“聊天机器人帮你写代码”而是一个可以运行在你本地终端里的AI Coding Agent。简单说你可以把它理解成一个懂项目结构、能读文件、能改代码、能跑命令的编程助手。OpenAI 官方对 Codex CLI 的定位也很明确它是一个可以在本地终端运行的 coding agent可以读取、修改并运行你当前目录下的代码。这篇文章我就按朋友之间教学的方式带你把Windows、Mac、Linux三个平台都跑一遍。一、先说结论Codex 有几种安装方式目前 Codex CLI 常见安装方式主要有这几种官方一键安装脚本npm 安装Homebrew 安装主要适合 MacWindows PowerShell 安装脚本官方 GitHub 和 npm 页面都给出了安装命令Mac / Linux 可以用curl脚本安装Windows 可以用 PowerShell 脚本安装也可以通过npm install -g openai/codex或brew install --cask codex安装。我个人建议Mac 用户优先用 Homebrew 或官方脚本。Linux 用户优先用官方脚本其次 npm。Windows 用户优先用 PowerShell 脚本不行再走 npm。开发者/折腾党直接 npm全平台通用。二、安装前准备安装 Codex 之前建议你先准备好这几个东西1. 一个 OpenAI / ChatGPT 账号Codex 是 OpenAI 的 coding agent所以你需要能正常登录 OpenAI 账号。如果你是在国内网络环境下使用可能会遇到登录失败、授权失败、网络超时等问题这种情况一般不是 Codex 本身坏了而是网络或账号环境问题。2. 一个终端工具不同系统终端不一样WindowsPowerShell / Windows TerminalMacTerminal / iTerm2Linux系统自带 Terminal / SSH 终端建议 Windows 用户直接装一个Windows Terminal体验会比传统 CMD 好很多。3. Node.js推荐备用虽然官方现在提供了一键安装脚本但很多朋友还是会用 npm 安装所以建议提前装好 Node.js。检查命令node-vnpm-v如果能正常显示版本号说明 Node.js 和 npm 已经装好了。三、Windows 安装 CodexWindows 用户可以用官方 PowerShell 脚本安装。1. 打开 PowerShell右键开始菜单选择Windows PowerShell或者打开Windows Terminal建议用管理员身份运行避免权限问题。2. 执行安装命令复制下面这行命令powershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex执行后它会自动下载安装 Codex CLI。官方 GitHub 给出的 Windows 安装方式就是通过这个 PowerShell 脚本安装。3. 检查是否安装成功安装完成后输入codex--version或者直接输入codex如果能进入 Codex 交互界面说明安装成功。4. Windows 常见问题问题一提示无法运行脚本如果 PowerShell 提示脚本无法执行可以先执行Set-ExecutionPolicyRemoteSigned-Scope CurrentUser然后重新执行安装命令。问题二提示 codex 不是内部或外部命令这个一般是环境变量没刷新。可以试试关闭当前 PowerShell重新打开 Windows Terminal再输入codex如果还不行可以重启电脑。问题三Windows 安装后闪退这种情况可能是依赖、路径或终端兼容问题。你可以换 npm 安装方式npminstall-gopenai/codex然后再执行codex四、Mac 安装 CodexMac 是目前用 Codex 比较舒服的平台尤其适合程序员本地开发。Mac 有两种推荐安装方式方式一官方脚本安装打开终端执行curl-fsSLhttps://chatgpt.com/codex/install.sh|sh这条命令是官方给 Mac / Linux 用户提供的一键安装方式。安装完成后执行codex能打开就说明成功。方式二Homebrew 安装如果你 Mac 上已经安装了 Homebrew也可以直接执行brewinstall--caskcodex官方安装说明里也列出了 Homebrew 这种安装方式。方式三npm 安装如果你更喜欢 npm也可以这样npminstall-gopenai/codex安装完成后codexMac 常见问题问题一提示 brew command not found说明你还没有安装 Homebrew。可以先安装 Homebrew或者直接用官方脚本curl-fsSLhttps://chatgpt.com/codex/install.sh|sh问题二提示 permission denied可以检查当前用户权限或者换 npm 的全局目录。临时解决可以试sudonpminstall-gopenai/codex但我个人不太建议长期用sudo npm装全局包后面可能会带来权限混乱。问题三安装成功但 codex 命令找不到大概率是 PATH 没生效。可以查看echo$PATH然后重启终端或者检查~/.zshrc/~/.bashrc配置。五、Linux 安装 CodexLinux 用户一般有两种场景一种是自己的 Linux 桌面系统另一种是服务器 SSH 环境。如果你是用服务器跑项目Codex 也可以直接在项目目录里使用。方式一官方脚本安装执行curl-fsSLhttps://chatgpt.com/codex/install.sh|sh这是 Mac / Linux 通用的官方安装脚本。安装完成后codex方式二npm 安装如果你已经安装了 Node.js 和 npm可以执行npminstall-gopenai/codex然后运行codexnpm 官方页面也展示了npm install -g openai/codex这种安装方式。Linux 常见问题问题一没有 curl如果提示curl:commandnot foundUbuntu / Debian 可以执行sudoaptupdatesudoaptinstall-ycurlCentOS / Rocky / AlmaLinux 可以执行sudoyuminstall-ycurl或者sudodnfinstall-ycurl问题二没有 Node.jsUbuntu 可以这样装sudoaptupdatesudoaptinstall-ynodejsnpm然后检查node-vnpm-v如果版本太旧建议去 Node.js 官方重新安装较新的 LTS 版本。问题三npm 全局安装没权限如果出现权限问题可以先试npmconfig get prefix不推荐一上来就乱用 sudo。更干净的方式是使用 nvm 管理 Node.js。不过如果你只是临时测试也可以sudonpminstall-gopenai/codex六、第一次使用 Codex安装完成后建议你进入一个真实项目目录比如cdmy-project然后执行codex第一次运行时一般会让你登录或授权。按照提示操作即可。进入 Codex 后你可以直接用自然语言下指令比如帮我分析这个项目的目录结构或者帮我找一下登录接口在哪里再比如帮我修复这个报错并告诉我你改了哪些文件Codex 和普通 ChatGPT 最大的区别是它不只是回答你它可以结合当前项目文件来分析问题。七、推荐的使用姿势很多人刚装完 Codex不知道第一句话该问什么。我给你几个实用提示词1. 分析项目请先阅读当前项目结构告诉我这个项目的技术栈、主要模块、启动方式和关键配置文件。2. 找 Bug这个项目现在启动报错请你帮我定位原因。先不要直接改代码先告诉我可能的问题点。3. 改功能请帮我新增一个用户列表接口要求使用现有项目风格不要引入新的框架。4. 写文档请根据当前项目生成一份 README.md包含项目介绍、环境要求、启动方式、目录结构和常见问题。5. 写测试请帮我为这个模块补充单元测试优先覆盖正常流程和常见异常流程。八、Codex 适合什么人我觉得 Codex 特别适合这几类朋友1. 经常接手老项目的人老项目最痛苦的不是写代码而是看不懂结构。你可以让 Codex 先帮你读目录、看配置、找入口这一步能省很多时间。2. 后端开发比如 Go、Java、Python、Node.js 项目Codex 可以帮你找接口、补 CRUD、写测试、改配置。3. 前端开发比如 Vue、React、Next.js 项目Codex 可以帮你找组件、改样式、分析页面结构。4. 运维和部署比如 Dockerfile、docker-compose、Nginx、CI/CD 配置Codex 也能帮你看问题。5. 自媒体/教程作者这个很多人忽略了。Codex 不仅能写代码也能根据项目生成教程、README、部署文档、接口说明非常适合做技术内容。九、Codex 安装失败怎么办这里给你一个排查顺序1. 先确认命令有没有输错比如 npm 安装命令应该是npminstall-gopenai/codex不要装一些奇怪的第三方包。之前也出现过假冒 Codex 相关工具的供应链安全事件有恶意 npm 包伪装成 Codex 周边工具窃取认证信息所以安装时一定要认准 OpenAI 官方仓库或官方 npm 包。2. 确认网络是否正常很多报错不是安装问题而是网络访问失败。可以先测试curlhttps://chatgpt.com如果访问不了Codex 安装和登录大概率也会失败。3. 确认 Node.js / npm 是否正常执行node-vnpm-v如果没有版本号先安装 Node.js。4. 确认环境变量如果安装成功但运行不了通常是 PATH 问题。可以关闭终端重新打开或者检查环境变量。5. 换一种安装方式如果官方脚本不行就换 npm。如果 npm 不行Mac 可以换 Homebrew。十、我个人推荐的安装方式最后给大家一个最简单的选择Windows优先powershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex备用npminstall-gopenai/codexMac优先brewinstall--caskcodex或者curl-fsSLhttps://chatgpt.com/codex/install.sh|sh备用npminstall-gopenai/codexLinux优先curl-fsSLhttps://chatgpt.com/codex/install.sh|sh备用npminstall-gopenai/codex十一、最后说几句Codex 这类 AI Coding Agent和以前的代码补全工具已经不是一个东西了。以前我们用 AI 写代码大多数时候是复制一段需求让它生成一段代码然后自己粘进去。现在 Codex 更像是直接进入你的项目帮你读代码、改代码、跑命令、解释问题。当然它不是万能的。我的建议是小改动可以让它直接做大改动一定要让它先分析方案。比如你可以先问先不要改代码请先分析这个需求需要改哪些文件以及可能有哪些风险。等它分析清楚后再让它动手。这样用起来会稳很多。如果你是第一次接触 AI 编程工具我建议你先从 Codex CLI 开始。安装不难使用门槛也不高真正用起来之后你会发现它很适合做项目理解、Bug 定位、代码重构和文档生成。这就是这篇 Codex 安装教程希望能帮你少踩坑。