目錄
  1. 一、 第一步：選擇入口與網路環境準備
  2. 1. 終端網路代理設定（CLI 必看）
  3. 2. 入口一：桌面 App（最省心、新手推薦）
  4. 3. 入口二：終端命令列工具（CLI，工程師推薦）
  5. 二、 第二步：登入與 OAuth 授權
  6. 三、 第三步：發一句話驗證執行狀態
  7. 四、 三大檢查點對照速查
  8. 五、 常見報錯與排查實錄
  9. 六、 安全上手：保護你的第一行程式碼

Codex 新手上路實操教程：桌面 App 與終端 CLI 雙端安裝、梯子代理與驗證全跑通指南

在眾多 AI 輔助程式設計工具中，OpenAI 推出的 Codex 無論是作為原生桌面應用，還是嵌入在終端裡的命令列 CLI，都展現出了極強的程式碼工程理解與自主交付能力。

但對於初次接觸它的開發者或產品經理來說，官方文件往往堆砌了大量術語，很多人在第一步——甚至在安裝腳本執行和網路連通性環節——就遇到了各種莫名其妙的報錯與連線超時。

其實，第一次安裝和跑通 Codex，根本不需要深究複雜的環境參數。只要走完三個核心動作：裝上軟體、登進帳號、發一句話確認有回覆。

Codex 新手安裝 3 大剛性檢查點

本文將拆解桌面 App 與終端命令列（CLI）兩種入口的完整實戰路徑，並直截了當給出國內網路環境下梯子與終端代理的設定命令。

一、 第一步：選擇入口與網路環境準備

在開始執行任何安裝前，首先確保你的電腦能夠穩定存取海外服務（確保能正常開啟 chatgpt.com）。

1. 終端網路代理設定（CLI 必看）

很多新手常犯的一個錯誤是：瀏覽器明明開了梯子能正常開啟 ChatGPT，但在終端執行下載腳本卻一直報 Connection Timed Out。

這是因為終端預設不走系統全域代理。在執行任何安裝命令前，Mac / Linux 使用者建議在終端執行以下命令顯式掛載本地代理埠（以常見的 Clash 本機 7890 埠為例）：

# 临时为当前终端设置 HTTP/HTTPS 与 SOCKS5 代理
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export all_proxy="socks5://127.0.0.1:7890"

# 验证终端网络是否畅通
curl -I https://chatgpt.com/codex

Windows PowerShell 使用者則執行：

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

只要能夠返回 HTTP 200 或 301 狀態碼，說明終端的網路隧道已經打通。

2. 入口一：桌面 App（最省心、新手推薦）

如果你習慣圖形化介面，不想折騰命令列環境，直接選擇桌面 App：

  1. 存取官方下載地址：https://chatgpt.com/codex；
  2. 下載對應作業系統的安裝包（macOS .dmg 或 Windows .exe）；
  3. 雙擊直接完成安裝。

桌面端的操作邏輯與日常聊天軟體完全一致，直觀、門檻極低。

3. 入口二：終端命令列工具（CLI，工程師推薦）

習慣在終端或者 VS Code 整合終端裡沉浸式敲程式碼的朋友，選擇 CLI 工具能帶來更高效的上下文互動。

Mac / Linux 使用者： 開啟終端，執行官方一鍵安裝腳本：

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

Windows 使用者： 以管理員身分開啟 PowerShell（注意：必須使用 PowerShell，嚴禁使用舊版 CMD），執行：

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

安裝腳本會自動拉取可執行二進位制檔案並寫入系統環境變數。安裝完成後，務必關閉當前終端視窗並重新開啟一個新的視窗，確保全域 Path 變數重新載入。

二、 第二步：登入與 OAuth 授權

安裝完成後，需要繫結你的 OpenAI / ChatGPT 帳戶：

  1. 桌面 App： 啟動應用程式後，介面會自動彈出登入按鈕，點選後跳轉至預設瀏覽器。登入你的 ChatGPT 帳號並點選「授權（Authorize）」即可。

  2. 命令列 CLI： 在終端輸入啟動命令：

    codex

    程式會自動在本機監聽一個臨時回執埠，並在系統預設瀏覽器中喚起授權頁面。在瀏覽器點選確認後，終端會自動捕獲 Token 並提示 Authentication successful。

三、 第三步：發一句話驗證執行狀態

裝上了，也登入了，怎麼確保它能正常幹活？最簡單的驗證不是讓它寫複雜演算法，而是做一次最樸素的連通性打招呼。

對於桌面 App： 在底部的輸入框裡直接傳送：

你好

對於命令列 CLI： 強烈建議不要直接在業務程式碼主目錄裡執行！先新建一個乾淨的空資料夾：

mkdir codex-test
cd codex-test
codex

進入互動提示符後，同樣輸入：

你好

只要它能流式返回一段通順的中文打招呼，說明本機程式執行環境、系統代理隧道、OAuth 權限認證、以及模型介面解析四層鏈路全部暢通無阻！

四、 三大檢查點對照速查

回過頭看，整個排查過程只需對照這 3 個確定性指標：

  1. 裝上了：桌面用戶端圖示能開啟，或者終端輸入 codex 能輸出幫助選單或進入互動式 Shell。
  2. 登進了：瀏覽器完成授權後，終端不再卡在等待登入憑證狀態。
  3. 說了話有回覆：傳送「你好」能即時收到中文回答。

五、 常見報錯與排查實錄

  • 報錯 command not found: codex： 新安裝的命令路徑未被當前會話捕獲。完全退出並重啟終端，或手動檢查 ~/.bashrc / ~/.zshrc 中的 PATH 匯出路徑。
  • Windows 報錯 irm is not recognized： 你誤用了古老的 cmd.exe。請按 Win + S 搜尋並開啟 PowerShell 重新執行。
  • 登入頁面死活打不開或一直白屏轉圈： OAuth 回撥依賴瀏覽器能正常載入海外登入元件。檢查梯子的全域代理狀態，確保沒有開啟某些會阻斷區域網本機迴環的激進分流規則。
  • 腳本下載一直卡在 0%： 終端沒有掛載代理。參考本文第一節的 export http_proxy 命令顯式設定後再試。

六、 安全上手：保護你的第一行程式碼

當你開始拿真實的專案工程給 Codex 體驗時，請養成一個極度重要的好習慣：剛開始接手專案的第一句話，先立規矩，不讓它亂改檔案。

推薦使用下面這段標準安全指令作為 Session 的開場白：

请先阅读当前工程的文件结构与 package.json，用中文向我简要概括这个项目是做什么的，以及包含哪些核心模块。
注意：本轮只做只读分析，严禁修改、创建或删除任何文件。

讓 AI 先把脈、講思路，你確認它的理解沒有偏離預期之後，再給它下達具體的檔案改寫指令。這能讓你從第一天起就遠離「一覺醒來程式碼全被重構亂了」的慘痛教訓。