前言

• 目前AI Agent市場可謂是遍地開花，現(xiàn)在最火的就是OpenAI旗下的 Codex 工具了！
• 老手早就各種Agent手到擒來，玩出花來的都有，而新手卻連怎樣安裝使用都不知道~
• 本文則帶來Codex最新入門教程，以及快速使用方法，繞過復(fù)雜冗余的繁瑣步驟，針對新手友好的教程。
• 讓感興趣的小伙伴可以先安裝完成、然后快速體驗Codex的實用功能，不講廢話直接開始。

本文基于 OpenAI 官方文檔整理，實際使用以官方頁面和賬號內(nèi)提示為準(zhǔn)。

一、 Codex 簡介

Codex 是 OpenAI 面向軟件開發(fā)的 coding agent。它可以讀取代碼、修改文件、運行命令、解釋項目結(jié)構(gòu)、修復(fù) bug、生成測試和輔助 code review。

官方文檔提到，Codex 可以通過多種方式使用：CLI、IDE、桌面端、移動端。對新手來說，最常用的是 桌面端 和 CLI。

本文主要講解Codex桌面端的使用方法，也是普通人最容易上手使用的一種方式，比CLI命令行器敲代碼的方式要友好的多！

二、安裝方法

在開始安裝Codex之前需要先安裝Node.js，可以簡單理解成是一個安裝包工具，安裝很多工具都推薦先安裝這個Node.js。

選擇自己電腦的合適版本下載安裝即可，node.js安裝地址：https://nodejs.org/zh-cn/download

檢查Node.js是否已安裝：

node --version
npm --version

2.1 安裝Codex CLI

Windows 安裝方法

# 安裝命令，需使用管理員模式打開 <終端>
npm i -g @openai/codex --registry=https://registry.npmmirror.com

# 可升到最新版
npm i -g @openai/codex@latest
# 檢查安裝狀態(tài)
codex --version

Linux / macOS 安裝方法

npm install -g @openai/codex
codex --version

如果報權(quán)限錯誤，則使用管理員模式安裝即可。

2.2 安裝Codex桌面端（推薦）

建議安裝使用桌面端Codex，相比CLI命令行來說桌面端更容易上手使用。

打開官網(wǎng)下載桌面端即可，根據(jù)自己的電腦類型選擇不同的下載方式。

下載安裝地址如下：https://openai.com/zh-Hans-CN/codex/

Windows用戶下載完之后，默認(rèn)是一個下載器。點擊之后還要跳轉(zhuǎn)到微軟商店下載，在微軟商店安裝之后就可以使用了，MAC用戶直接下載安裝之后即可正常使用。

如果微軟商店無法正常安裝，可以參考下面這種安裝Codex的方式。

使用 rg-adguard 提取離線包 的方式獲取安裝包，這是豆包姐告訴我的方法，親測可以正常下載安裝。

1. 打開：store.rg-adguard.net
2. 粘貼這個鏈接：https://apps.microsoft.com/detail/9plm9xgg6vks
3. 選擇：Retail → 點對勾
4. 下載 .msixbundle，如果下載不了，可以嘗試換個瀏覽器下載。

1. 使用管理員終端進行安裝Codex 主包：
   Add-AppxPackage E:\Downloads\OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0.Msix
2. 安裝完之后正常打開使用即可。

三、Codex CLI

安裝完Codex首次啟動時，會提示登錄。

官方文檔說明，可以使用 ChatGPT 賬號或 API key 進行認(rèn)證，兩種登錄方式都可以，選擇自己的即可。

CLI的使用方式與其他Agent沒有什么區(qū)別，首次使用需要設(shè)置沙盒環(huán)境，其他的功能都是用自然語言描述自己的需求即可，與眾多Agent使用方法基本類似。

四、Codex 桌面端

4.1 設(shè)置頁面（語言、寵物、個性化等）

設(shè)置頁面有很多設(shè)置，這里介紹一些比較常用的功能，如設(shè)置語言、主題、寵物及個性化設(shè)置等。

設(shè)置語言方法如下：

設(shè)置Codex主題如下，有深色和淺色兩種設(shè)置。

設(shè)置寵物方法如下，默認(rèn)有幾種內(nèi)置寵物，也可以自己創(chuàng)建或者去一些網(wǎng)站下載自己想要的寵物形象！

查看使用情況和計費，在次數(shù)可以查看剩余5小時額度和每周額度。

Codex個性化設(shè)置，此處與ClaudeCode的CLAUDE.md功能一致，很建議按自己的風(fēng)格修改一下內(nèi)容。

# CLAUDE.md

Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.

**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.

## 1. Think Before Coding

**Don't assume. Don't hide confusion. Surface tradeoffs.**

Before implementing:
- State your assumptions explicitly. If uncertain, ask.
- If multiple interpretations exist, present them - don't pick silently.
- If a simpler approach exists, say so. Push back when warranted.
- If something is unclear, stop. Name what's confusing. Ask.

## 2. Simplicity First

**Minimum code that solves the problem. Nothing speculative.**

- No features beyond what was asked.
- No abstractions for single-use code.
- No "flexibility" or "configurability" that wasn't requested.
- No error handling for impossible scenarios.
- If you write 200 lines and it could be 50, rewrite it.

Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.

## 3. Surgical Changes

**Touch only what you must. Clean up only your own mess.**

When editing existing code:
- Don't "improve" adjacent code, comments, or formatting.
- Don't refactor things that aren't broken.
- Match existing style, even if you'd do it differently.
- If you notice unrelated dead code, mention it - don't delete it.

When your changes create orphans:
- Remove imports/variables/functions that YOUR changes made unused.
- Don't remove pre-existing dead code unless asked.

The test: Every changed line should trace directly to the user's request.

## 4. Goal-Driven Execution

**Define success criteria. Loop until verified.**

Transform tasks into verifiable goals:
- "Add validation" → "Write tests for invalid inputs, then make them pass"
- "Fix the bug" → "Write a test that reproduces it, then make it pass"
- "Refactor X" → "Ensure tests pass before and after"

For multi-step tasks, state a brief plan:

1. [Step] → verify: [check]
2. [Step] → verify: [check]
3. [Step] → verify: [check]

Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.

## 5. 用戶偏好

默認(rèn)全部使用中文回復(fù)，英文特殊詞語或關(guān)鍵詞除外。

其他的設(shè)置可以按需挨個打開看下，調(diào)整為更適合自己的使用習(xí)慣即可。

4.2 布局區(qū)域

本文著重來介紹Codex桌面版的使用，頁面采用三欄布局。

左側(cè)多功能區(qū)可以創(chuàng)建新對話、搜索對話內(nèi)容、添加插件和技能、自動化(添加定時任務(wù))及Codex移動版(使用手機控制Codex)

中間則是跟網(wǎng)頁端類似的功能，正常對話進行問答，右側(cè)則是針對本次會話的任務(wù)區(qū)域，進行側(cè)邊聊天和修改審查等。

4.3 工作區(qū)管理

在使用Codex可以使用工作區(qū)來區(qū)分不同的任務(wù)需求，可以新建空白項目，或者使用現(xiàn)有文件夾。

不同的工作內(nèi)容可以分成多個工作區(qū)，這樣可以有效管理不同的任務(wù)需求。

4.4 添加插件和技能（重要）

可以給Codex添加各種插件和技能，比如很火的HyperFarmes by HeyGen(構(gòu)建視頻)、Remotion(動畫)等。

也可以根據(jù)自己的需求創(chuàng)建插件和技能，插件和技能使用邏輯與ClaudeCode無太大差異。

插件和技能這里是目前Codex大火的原因之一，有很多非常好用的插件可以一鍵安裝使用。

4.5 配置模型，計劃模式和追求目標(biāo)

Codex可以隱藏兩側(cè)邊欄，只專注于對話。

右下方可以切換當(dāng)前使用的模型，左下方則可以使用添加的插件和設(shè)置 計劃模式、追求目標(biāo)(goal)模式。

計劃模式開啟后，可以跟Codex描述一個需求。Codex不會立馬執(zhí)行這個需求，而是會根據(jù)這個需求去寫一份執(zhí)行計劃，計劃寫完之后供我們查閱，如果覺得沒問題之后再讓Codex按這個計劃實施即可，計劃有問題則可以繼續(xù)修改。

這樣做的好處是需求先告訴AI，讓AI充分理解并指定計劃之后再真正的做事，可以有效避免AI沒能理解我們的需求，或者沒有計劃步驟的一股腦瞎干活~

追求目標(biāo)則是給Codex一個大目標(biāo)，它自己拆步驟、自動做完。
Codex 會自動：分析項目結(jié)構(gòu)，改文件、裝依賴，跑測試、修復(fù)報錯，最后輸出結(jié)果報告。

4.6 權(quán)限管理

codex 是依靠沙箱進行文件管理的，codex 將整個項目文件夾視為一個沙箱進行操作。

共有三種權(quán)限可以選擇：默認(rèn)權(quán)限、自動審查、完全訪問權(quán)限。新手建議自動審查即可。

五、 賬戶與訂閱

前面講了Codex常用的兩種方式：CLI和桌面端，下面簡單提一下賬戶的幾種使用方法。

• 第一種是官方直連，需要使用魔法去官網(wǎng)注冊O(shè)penAI的GPT賬號，然后正常購買訂閱套餐，在Codex中登錄使用就可以了。直連也有幾種方式，比如使用Google Play購買套餐，或者蘋果土區(qū)購買禮品卡等，目前都可正常使用。
• 第二種則是使用一些AI中轉(zhuǎn)站，目前市面上隨便一搜都是各種中轉(zhuǎn)站。優(yōu)點是國內(nèi)網(wǎng)絡(luò)即可正常訪問，缺點則是信息不安全，全憑中轉(zhuǎn)站良心操作。

價格與訂閱方案

目前GPT提供了多種訂閱方案，可根據(jù)自己的需求購買。
值得注意的是目前GPT網(wǎng)頁端跟Codex中的額度計算是分開的，所以哪怕Codex額度用光了，也可以繼續(xù)在網(wǎng)頁端使用GPT進行對話和生成圖片的功能。

六、使用技巧

6.1 Codex中一直Reconnecting的解決方案

問題描述：
發(fā)起請求后，長時間沒有正式輸出，中間不斷顯示 Reconnecting… 1/5、2/5、…、5/5，之后才進入正?；貜?fù)，或者提示回退到 HTTPS 傳輸。

這是因為客戶端優(yōu)先嘗試 WebSocket 通道，如果跑不通嘗試5次之后才會使用HTTPS。

解決方法：
在 用戶名/.codex/ 文件目錄下新增一個.env文件，文件內(nèi)容如下，換成自己的代理端口即可。

HTTP_PROXY=http://127.0.0.1:代理端口號
HTTPS_PROXY=http://127.0.0.1:代理端口號

或者把代理開TUN模式也可以解決這個問題。

6.2 常用提示詞模板

項目理解

請閱讀當(dāng)前項目，輸出：
1. 項目技術(shù)棧；
2. 啟動命令；
3. 測試命令；
4. 主要目錄說明；
5. 新手應(yīng)該先看哪些文件。
不要修改文件。

修復(fù) bug

問題：[粘貼錯誤現(xiàn)象或報錯信息]
復(fù)現(xiàn)步驟：[寫清楚如何觸發(fā)]
要求：
1. 先定位原因；
2. 只做必要修改；
3. 不重構(gòu)無關(guān)代碼；
4. 修改后運行相關(guān)測試；
5. 用中文總結(jié)。

Code Review

請 review 當(dāng)前 git diff。
重點關(guān)注：
1. 潛在 bug；
2. 邊界情況；
3. 安全風(fēng)險；
4. 缺少的測試；
5. 是否有無關(guān)修改。

6.3 使用小竅門

• 任務(wù)越小，結(jié)果越穩(wěn)定。先從單個 bug、單個組件、單個測試文件開始。
• 先讓 Codex 分析，再讓它修改。可以明確寫“先不要改代碼”。
• 給成功標(biāo)準(zhǔn)。例如“運行 npm test 通過”比“修好它”更清楚。
• 合并前一定看 diff。尤其是依賴、配置、權(quán)限、數(shù)據(jù)庫遷移相關(guān)改動。
• 可以在項目中維護 AGENTS.md，寫清團隊規(guī)范，例如回復(fù)語言、測試要求、禁止無關(guān)重構(gòu)等。

總結(jié)

• 本文介紹了Codex的常用兩種安裝方法，盡量用簡介的文本去介紹，防止看起來一團亂碼無從下手。
• 著重介紹了Codex桌面端的常見使用方法，對比命令行的模式，桌面端是非常友好的使用方式了。
• 文章內(nèi)容主要面對新手，想快速上手使用Codex時參考使用，更多深度使用方法后續(xù)還會繼續(xù)介紹的！

以上就是Codex安裝、入門和快速使用的新手教程的詳細內(nèi)容，更多關(guān)于Codex新手教程的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論