最近很多朋友都在問我：Codex 到底怎么安裝？Windows 能不能用？Mac 怎么裝？Linux 服務(wù)器上能不能跑？

我的建議是：如果你平時(shí)經(jīng)常寫代碼、改項(xiàng)目、看源碼，Codex 真的值得裝一下。它不是單純的“聊天機(jī)器人幫你寫代碼”，而是一個(gè)可以運(yùn)行在你本地終端里的 AI Coding Agent。簡單說，你可以把它理解成一個(gè)懂項(xiàng)目結(jié)構(gòu)、能讀文件、能改代碼、能跑命令的編程助手。

OpenAI 官方對(duì) Codex CLI 的定位也很明確：它是一個(gè)可以在本地終端運(yùn)行的 coding agent，可以讀取、修改并運(yùn)行你當(dāng)前目錄下的代碼。

這篇文章我就按朋友之間教學(xué)的方式，帶你把 Windows、Mac、Linux 三個(gè)平臺(tái)都跑一遍。

一、先說結(jié)論：Codex 有幾種安裝方式？

目前 Codex CLI 常見安裝方式主要有這幾種：

1. 官方一鍵安裝腳本
2. npm 安裝
3. Homebrew 安裝，主要適合 Mac
4. Windows PowerShell 安裝腳本

官方 GitHub 和 npm 頁面都給出了安裝命令：Mac / Linux 可以用 curl 腳本安裝，Windows 可以用 PowerShell 腳本安裝，也可以通過 npm install -g @openai/codex 或 brew install --cask codex 安裝。

我個(gè)人建議：

• Mac 用戶：優(yōu)先用 Homebrew 或官方腳本。
• Linux 用戶：優(yōu)先用官方腳本，其次 npm。
• Windows 用戶：優(yōu)先用 PowerShell 腳本，不行再走 npm。
• 開發(fā)者/折騰黨：直接 npm，全平臺(tái)通用。

二、安裝前準(zhǔn)備

安裝 Codex 之前，建議你先準(zhǔn)備好這幾個(gè)東西：

1. 一個(gè) OpenAI / ChatGPT 賬號(hào)

Codex 是 OpenAI 的 coding agent，所以你需要能正常登錄 OpenAI 賬號(hào)。

如果你是在國內(nèi)網(wǎng)絡(luò)環(huán)境下使用，可能會(huì)遇到登錄失敗、授權(quán)失敗、網(wǎng)絡(luò)超時(shí)等問題，這種情況一般不是 Codex 本身壞了，而是網(wǎng)絡(luò)或賬號(hào)環(huán)境問題。

2. 一個(gè)終端工具

不同系統(tǒng)終端不一樣：

• Windows：PowerShell / Windows Terminal
• Mac：Terminal / iTerm2
• Linux：系統(tǒng)自帶 Terminal / SSH 終端

建議 Windows 用戶直接裝一個(gè) Windows Terminal，體驗(yàn)會(huì)比傳統(tǒng) CMD 好很多。

3. Node.js，推薦備用

雖然官方現(xiàn)在提供了一鍵安裝腳本，但很多朋友還是會(huì)用 npm 安裝，所以建議提前裝好 Node.js。

檢查命令：

node -v
npm -v

如果能正常顯示版本號(hào)，說明 Node.js 和 npm 已經(jīng)裝好了。

三、Windows 安裝 Codex

Windows 用戶可以用官方 PowerShell 腳本安裝。

1. 打開 PowerShell

右鍵開始菜單，選擇：

Windows PowerShell

或者打開：

Windows Terminal

建議用管理員身份運(yùn)行，避免權(quán)限問題。

2. 執(zhí)行安裝命令

復(fù)制下面這行命令：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

執(zhí)行后，它會(huì)自動(dòng)下載安裝 Codex CLI。

官方 GitHub 給出的 Windows 安裝方式就是通過這個(gè) PowerShell 腳本安裝。

3. 檢查是否安裝成功

安裝完成后，輸入：

codex --version

或者直接輸入：

codex

如果能進(jìn)入 Codex 交互界面，說明安裝成功。

4. Windows 常見問題

問題一：提示無法運(yùn)行腳本

如果 PowerShell 提示腳本無法執(zhí)行，可以先執(zhí)行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新執(zhí)行安裝命令。

問題二：提示 codex 不是內(nèi)部或外部命令

這個(gè)一般是環(huán)境變量沒刷新。

可以試試：

1. 關(guān)閉當(dāng)前 PowerShell
2. 重新打開 Windows Terminal
3. 再輸入：

codex

如果還不行，可以重啟電腦。

問題三：Windows 安裝后閃退

這種情況可能是依賴、路徑或終端兼容問題。你可以換 npm 安裝方式：

npm install -g @openai/codex

然后再執(zhí)行：

codex

四、Mac 安裝 Codex

Mac 是目前用 Codex 比較舒服的平臺(tái)，尤其適合程序員本地開發(fā)。

Mac 有兩種推薦安裝方式：

方式一：官方腳本安裝

打開終端，執(zhí)行：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

這條命令是官方給 Mac / Linux 用戶提供的一鍵安裝方式。

安裝完成后，執(zhí)行：

codex

能打開就說明成功。

方式二：Homebrew 安裝

如果你 Mac 上已經(jīng)安裝了 Homebrew，也可以直接執(zhí)行：

brew install --cask codex

官方安裝說明里也列出了 Homebrew 這種安裝方式。

方式三：npm 安裝

如果你更喜歡 npm，也可以這樣：

npm install -g @openai/codex

安裝完成后：

codex

Mac 常見問題

問題一：提示 brew command not found

說明你還沒有安裝 Homebrew。

可以先安裝 Homebrew，或者直接用官方腳本：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

問題二：提示 permission denied

可以檢查當(dāng)前用戶權(quán)限，或者換 npm 的全局目錄。

臨時(shí)解決可以試：

sudo npm install -g @openai/codex

但我個(gè)人不太建議長期用 sudo npm 裝全局包，后面可能會(huì)帶來權(quán)限混亂。

問題三：安裝成功但 codex 命令找不到

大概率是 PATH 沒生效。

可以查看：

echo $PATH

然后重啟終端，或者檢查 ~/.zshrc / ~/.bashrc 配置。

五、Linux 安裝 Codex

Linux 用戶一般有兩種場(chǎng)景：

一種是自己的 Linux 桌面系統(tǒng)，另一種是服務(wù)器 SSH 環(huán)境。

如果你是用服務(wù)器跑項(xiàng)目，Codex 也可以直接在項(xiàng)目目錄里使用。

方式一：官方腳本安裝

執(zhí)行：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

這是 Mac / Linux 通用的官方安裝腳本。

安裝完成后：

codex

方式二：npm 安裝

如果你已經(jīng)安裝了 Node.js 和 npm，可以執(zhí)行：

npm install -g @openai/codex

然后運(yùn)行：

codex

npm 官方頁面也展示了 npm install -g @openai/codex 這種安裝方式。

Linux 常見問題

問題一：沒有 curl

如果提示：

curl: command not found

Ubuntu / Debian 可以執(zhí)行：

sudo apt update
sudo apt install -y curl

CentOS / Rocky / AlmaLinux 可以執(zhí)行：

sudo yum install -y curl

或者：

sudo dnf install -y curl

問題二：沒有 Node.js

Ubuntu 可以這樣裝：

sudo apt update
sudo apt install -y nodejs npm

然后檢查：

node -v
npm -v

如果版本太舊，建議去 Node.js 官方重新安裝較新的 LTS 版本。

問題三：npm 全局安裝沒權(quán)限

如果出現(xiàn)權(quán)限問題，可以先試：

npm config get prefix

不推薦一上來就亂用 sudo。更干凈的方式是使用 nvm 管理 Node.js。

不過如果你只是臨時(shí)測(cè)試，也可以：

sudo npm install -g @openai/codex

六、第一次使用 Codex

安裝完成后，建議你進(jìn)入一個(gè)真實(shí)項(xiàng)目目錄，比如：

cd my-project

然后執(zhí)行：

codex

第一次運(yùn)行時(shí)，一般會(huì)讓你登錄或授權(quán)。按照提示操作即可。

進(jìn)入 Codex 后，你可以直接用自然語言下指令，比如：

幫我分析這個(gè)項(xiàng)目的目錄結(jié)構(gòu)

或者：

幫我找一下登錄接口在哪里

再比如：

幫我修復(fù)這個(gè)報(bào)錯(cuò)，并告訴我你改了哪些文件

Codex 和普通 ChatGPT 最大的區(qū)別是：它不只是回答你，它可以結(jié)合當(dāng)前項(xiàng)目文件來分析問題。

七、推薦的使用姿勢(shì)

很多人剛裝完 Codex，不知道第一句話該問什么。

我給你幾個(gè)實(shí)用提示詞：

1. 分析項(xiàng)目

請(qǐng)先閱讀當(dāng)前項(xiàng)目結(jié)構(gòu)，告訴我這個(gè)項(xiàng)目的技術(shù)棧、主要模塊、啟動(dòng)方式和關(guān)鍵配置文件。

2. 找 Bug

這個(gè)項(xiàng)目現(xiàn)在啟動(dòng)報(bào)錯(cuò)，請(qǐng)你幫我定位原因。先不要直接改代碼，先告訴我可能的問題點(diǎn)。

3. 改功能

請(qǐng)幫我新增一個(gè)用戶列表接口，要求使用現(xiàn)有項(xiàng)目風(fēng)格，不要引入新的框架。

4. 寫文檔

請(qǐng)根據(jù)當(dāng)前項(xiàng)目生成一份 README.md，包含項(xiàng)目介紹、環(huán)境要求、啟動(dòng)方式、目錄結(jié)構(gòu)和常見問題。

5. 寫測(cè)試

請(qǐng)幫我為這個(gè)模塊補(bǔ)充單元測(cè)試，優(yōu)先覆蓋正常流程和常見異常流程。

八、Codex 適合什么人？

我覺得 Codex 特別適合這幾類朋友：

1. 經(jīng)常接手老項(xiàng)目的人

老項(xiàng)目最痛苦的不是寫代碼，而是看不懂結(jié)構(gòu)。

你可以讓 Codex 先幫你讀目錄、看配置、找入口，這一步能省很多時(shí)間。

2. 后端開發(fā)

比如 Go、Java、Python、Node.js 項(xiàng)目，Codex 可以幫你找接口、補(bǔ) CRUD、寫測(cè)試、改配置。

3. 前端開發(fā)

比如 Vue、React、Next.js 項(xiàng)目，Codex 可以幫你找組件、改樣式、分析頁面結(jié)構(gòu)。

4. 運(yùn)維和部署

比如 Dockerfile、docker-compose、Nginx、CI/CD 配置，Codex 也能幫你看問題。

5. 自媒體/教程作者

這個(gè)很多人忽略了。

Codex 不僅能寫代碼，也能根據(jù)項(xiàng)目生成教程、README、部署文檔、接口說明，非常適合做技術(shù)內(nèi)容。

九、Codex 安裝失敗怎么辦？

這里給你一個(gè)排查順序：

1. 先確認(rèn)命令有沒有輸錯(cuò)

比如 npm 安裝命令應(yīng)該是：

npm install -g @openai/codex

不要裝一些奇怪的第三方包。

之前也出現(xiàn)過假冒 Codex 相關(guān)工具的供應(yīng)鏈安全事件，有惡意 npm 包偽裝成 Codex 周邊工具竊取認(rèn)證信息，所以安裝時(shí)一定要認(rèn)準(zhǔn) OpenAI 官方倉庫或官方 npm 包。

2. 確認(rèn)網(wǎng)絡(luò)是否正常

很多報(bào)錯(cuò)不是安裝問題，而是網(wǎng)絡(luò)訪問失敗。

可以先測(cè)試：

curl https://chatgpt.com

如果訪問不了，Codex 安裝和登錄大概率也會(huì)失敗。

3. 確認(rèn) Node.js / npm 是否正常

執(zhí)行：

node -v
npm -v

如果沒有版本號(hào)，先安裝 Node.js。

4. 確認(rèn)環(huán)境變量

如果安裝成功但運(yùn)行不了，通常是 PATH 問題。

可以關(guān)閉終端重新打開，或者檢查環(huán)境變量。

5. 換一種安裝方式

如果官方腳本不行，就換 npm。

如果 npm 不行，Mac 可以換 Homebrew。

十、我個(gè)人推薦的安裝方式

最后給大家一個(gè)最簡單的選擇：

Windows

優(yōu)先：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

備用：

npm install -g @openai/codex

Mac

優(yōu)先：

brew install --cask codex

或者：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

備用：

npm install -g @openai/codex

Linux

優(yōu)先：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

備用：

npm install -g @openai/codex

十一、最后說幾句

Codex 這類 AI Coding Agent，和以前的代碼補(bǔ)全工具已經(jīng)不是一個(gè)東西了。

以前我們用 AI 寫代碼，大多數(shù)時(shí)候是復(fù)制一段需求，讓它生成一段代碼，然后自己粘進(jìn)去。

現(xiàn)在 Codex 更像是直接進(jìn)入你的項(xiàng)目，幫你讀代碼、改代碼、跑命令、解釋問題。

當(dāng)然，它不是萬能的。我的建議是：

小改動(dòng)可以讓它直接做，大改動(dòng)一定要讓它先分析方案。

比如你可以先問：

先不要改代碼，請(qǐng)先分析這個(gè)需求需要改哪些文件，以及可能有哪些風(fēng)險(xiǎn)。

等它分析清楚后，再讓它動(dòng)手。

這樣用起來會(huì)穩(wěn)很多。

如果你是第一次接觸 AI 編程工具，我建議你先從 Codex CLI 開始。安裝不難，使用門檻也不高，真正用起來之后，你會(huì)發(fā)現(xiàn)它很適合做項(xiàng)目理解、Bug 定位、代碼重構(gòu)和文檔生成。

這就是這篇 Codex 安裝教程，希望能幫你少踩坑。

以上就是Codex三端安裝的完整指南(Windows/Mac/Linux)的詳細(xì)內(nèi)容，更多關(guān)于Codex三端安裝指南的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論