過去一段時(shí)間，我主要用 Claude Code 做本地代碼協(xié)作：讀倉庫、改代碼、跑測試、解釋報(bào)錯(cuò)、做 review。它的交互方式足夠順手，尤其適合在終端里直接把一個(gè)任務(wù)推進(jìn)到可提交狀態(tài)。

但最近我遇到了一個(gè)比較現(xiàn)實(shí)的問題：我的 Anthropic 賬戶被封了。結(jié)合當(dāng)時(shí) Anthropic 對(duì)阿里千問相關(guān)“反蒸餾”風(fēng)控的討論，我的判斷是賬戶觸發(fā)了相關(guān)風(fēng)險(xiǎn)策略。無論具體原因如何，結(jié)果都一樣：原來的 Claude Code 工作流不可用了。

所以我開始把主力編碼代理遷移到 Codex CLI。遷移之后的體感是：Codex CLI 不是 Claude Code 的一比一替代品，它更像一個(gè)“終端優(yōu)先的本地工程代理”。如果把它當(dāng)成普通聊天機(jī)器人，會(huì)覺得不夠順手；但如果圍繞倉庫、權(quán)限、配置和可復(fù)用指令來使用，它可以非常穩(wěn)定地接管日常開發(fā)工作。

本文記錄我的遷移方式和一些 Codex CLI 使用技巧。

遷移前先調(diào)整心智模型

Claude Code 的體驗(yàn)更像“我在終端里叫一個(gè)會(huì)寫代碼的同事過來”。Codex CLI 更強(qiáng)調(diào)幾個(gè)工程化概念：

• 工作目錄：Codex 會(huì)圍繞當(dāng)前目錄讀取代碼、修改文件、運(yùn)行命令。
• 權(quán)限與沙箱：它默認(rèn)不會(huì)隨便動(dòng)工作區(qū)之外的文件，也不會(huì)無提示地執(zhí)行高風(fēng)險(xiǎn)操作。
• 持久化配置：常用模型、審批策略、沙箱、MCP、主題、日志等都可以寫進(jìn) ~/.codex/config.toml。
• 項(xiàng)目指令：通過 AGENTS.md 把倉庫規(guī)范、測試命令、代碼風(fēng)格固化下來。
• 可恢復(fù)會(huì)話：本地會(huì)話會(huì)保存，可以用 codex resume 回到之前的上下文。

遷移時(shí)最重要的變化是：不要每次都從零開始給代理解釋項(xiàng)目。應(yīng)該把穩(wěn)定規(guī)則寫入配置和 AGENTS.md，把一次性目標(biāo)寫在當(dāng)前 prompt 里。

安裝與登錄后的第一組命令

安裝和登錄完成后，我建議先跑這幾個(gè)命令確認(rèn)環(huán)境：

codex doctor
codex features list
codex "解釋一下這個(gè)代碼庫的結(jié)構(gòu)"

codex doctor 用來檢查本地安裝、認(rèn)證、終端、Git、配置和會(huì)話狀態(tài)。剛遷移時(shí)先跑它，可以快速排除很多環(huán)境問題。

日常進(jìn)入交互模式：

codex

帶著一個(gè)初始任務(wù)進(jìn)入：

codex "閱讀這個(gè)項(xiàng)目，找出啟動(dòng)命令、測試命令和主要模塊"

如果只是要一次性處理一個(gè)任務(wù)，不想進(jìn)入完整 TUI，可以用：

codex exec "修復(fù)當(dāng)前測試失敗，并說明修改原因"

推薦的基礎(chǔ)配置

Codex 的個(gè)人配置一般放在：

~/.codex/config.toml

我建議先從保守但高效的配置開始：

model = "gpt-5.5"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"
model_reasoning_effort = "high"
personality = "pragmatic"

[features]
shell_snapshot = true
multi_agent = true

這組配置的含義：

• model = "gpt-5.5"：把主力模型設(shè)為當(dāng)前 Codex 推薦的復(fù)雜編碼任務(wù)模型。
• approval_policy = "on-request"：需要越權(quán)或高風(fēng)險(xiǎn)操作時(shí)再問你。
• sandbox_mode = "workspace-write"：允許在當(dāng)前工作區(qū)讀寫和運(yùn)行命令，但限制工作區(qū)外操作。
• web_search = "cached"：默認(rèn)使用緩存搜索，降低直接訪問網(wǎng)頁帶來的提示注入風(fēng)險(xiǎn)。
• model_reasoning_effort = "high"：復(fù)雜任務(wù)給模型更多推理預(yù)算。
• personality = "pragmatic"：讓輸出更偏工程執(zhí)行，而不是泛泛解釋。

臨時(shí)覆蓋配置可以直接在命令里加 -c：

codex -c model_reasoning_effort=medium "快速解釋這個(gè)報(bào)錯(cuò)"

臨時(shí)切模型：

codex --model gpt-5.5 "重構(gòu)這個(gè)模塊并補(bǔ)測試"

用 AGENTS.md 固化項(xiàng)目規(guī)則

遷移到 Codex CLI 后，最值得做的一件事就是給項(xiàng)目加 AGENTS.md。它相當(dāng)于給代理看的項(xiàng)目說明書。

在倉庫根目錄創(chuàng)建：

# AGENTS.md
## 項(xiàng)目約定
- 修改 TypeScript 文件后運(yùn)行 `npm run lint` 和 `npm test`。
- 不要引入新的生產(chǎn)依賴，除非先說明原因。
- API 行為變更必須同步更新 `docs/`。
- 保持改動(dòng)范圍最小，不做無關(guān)重構(gòu)。
## 常用命令
- 安裝依賴：`npm install`
- 本地開發(fā)：`npm run dev`
- 測試：`npm test`
- 構(gòu)建：`npm run build`

如果某個(gè)子目錄有特殊規(guī)則，可以在子目錄放另一個(gè) AGENTS.md 或 AGENTS.override.md。Codex 會(huì)從項(xiàng)目根目錄一路讀到當(dāng)前目錄，越靠近當(dāng)前目錄的規(guī)則越具體。

全局個(gè)人偏好可以寫到：

~/.codex/AGENTS.md

例如：

# ~/.codex/AGENTS.md
## 我的默認(rèn)偏好
- 回答使用中文。
- 修改前先說明要?jiǎng)幽男┪募?
- 完成后說明驗(yàn)證命令和結(jié)果。
- 不要自動(dòng)提交 git commit，除非我明確要求。

這樣每個(gè)項(xiàng)目都會(huì)繼承你的個(gè)人工作習(xí)慣。

日常工作流：從“聊天”變成“任務(wù)委派”

我現(xiàn)在使用 Codex CLI 的方式大概是這樣：

1. 讓 Codex 先建立項(xiàng)目地圖

進(jìn)入新倉庫后先問：

codex "閱讀項(xiàng)目結(jié)構(gòu)，告訴我入口文件、核心模塊、測試命令、構(gòu)建命令和潛在風(fēng)險(xiǎn)點(diǎn)。不要修改文件。"

這個(gè)階段只讓它讀，不讓它改。等它理解項(xiàng)目后，再給具體任務(wù)。

2. 小步提交任務(wù)

不要一次說“重構(gòu)整個(gè)系統(tǒng)”。更好的 prompt 是：

修復(fù)登錄頁在 token 過期后沒有跳轉(zhuǎn)的問題。
要求：
1. 先定位相關(guān)代碼。
2. 只修改必要文件。
3. 補(bǔ)一個(gè)覆蓋 token 過期場景的測試。
4. 運(yùn)行相關(guān)測試并匯報(bào)結(jié)果。

Codex 擅長把任務(wù)拆成“讀代碼 -> 制定計(jì)劃 -> 修改 -> 驗(yàn)證”。你給它的邊界越清楚，結(jié)果越穩(wěn)定。

3. 用 review 模式檢查改動(dòng)

改完后可以在交互模式里用：

/review

它會(huì)按 review 視角檢查當(dāng)前 diff，重點(diǎn)找 bug、回歸風(fēng)險(xiǎn)和缺失測試。遷移后我很依賴這個(gè)功能，因?yàn)樗馨?ldquo;寫代碼”和“審代碼”拆成兩個(gè)角色。

也可以直接要求：

codex "以代碼審查者身份檢查當(dāng)前未提交改動(dòng)，只列出明確的問題和對(duì)應(yīng)文件行號(hào)。"

4. 用 resume 接上歷史上下文

Codex 會(huì)保存本地會(huì)話。中斷后繼續(xù)：

codex resume

直接恢復(fù)最近一次：

codex resume --last

如果你昨天已經(jīng)讓它分析過項(xiàng)目，今天可以接著說：

codex resume --last "繼續(xù)昨天的遷移計(jì)劃，先處理配置模塊。"

這比重新粘貼一堆背景信息更省心。

常用快捷技巧

讓 Codex 只讀不改

適合做解釋、排查、方案設(shè)計(jì)：

codex --sandbox read-only "分析為什么這個(gè)測試會(huì)失敗，不要修改文件"

給額外目錄授權(quán)

如果當(dāng)前項(xiàng)目需要同時(shí)讀取另一個(gè)本地目錄：

codex --add-dir ../shared-lib "檢查當(dāng)前項(xiàng)目和 shared-lib 的接口是否一致"

需要最新信息時(shí)打開實(shí)時(shí)搜索

默認(rèn)搜索是緩存模式。如果要查最新版本、最新 API 或近期變更：

codex --search "查最新 Next.js 版本下這個(gè)配置項(xiàng)是否還有效"

給截圖或設(shè)計(jì)稿

Codex CLI 可以帶圖片輸入：

codex -i screenshot.png "根據(jù)這個(gè)報(bào)錯(cuò)截圖定位可能原因"

多個(gè)圖片：

codex --image before.png,after.png "比較兩個(gè)界面差異，并指出可能的 CSS 問題"

安裝 shell 補(bǔ)全

codex completion zsh
codex completion bash
codex completion fish
codex completion power-shell

PowerShell 用戶可以先查看輸出，再按自己的 profile 方式加載。

Claude Code 用戶遷移時(shí)容易踩的坑

1. 不寫項(xiàng)目指令，導(dǎo)致每次都重新解釋

Claude Code 用戶很容易習(xí)慣“臨時(shí)口頭交代”。遷到 Codex 后，建議盡快把重復(fù)內(nèi)容沉淀到 AGENTS.md。比如測試命令、包管理器、代碼風(fēng)格、禁止事項(xiàng)，都應(yīng)該寫進(jìn)去。

2. 權(quán)限開太大

Codex 支持 Full Access，也支持 --dangerously-bypass-approvals-and-sandbox。但日常開發(fā)不建議這么用。我的默認(rèn)選擇是：

approval_policy = "on-request"
sandbox_mode = "workspace-write"

只有在臨時(shí)容器、一次性沙盒或完全可信的環(huán)境里，才考慮放寬權(quán)限。

3. 任務(wù)太大，反饋周期太長

不要直接讓它“完成整個(gè)遷移”。更好的拆法是：

• 先讓它讀代碼并輸出計(jì)劃。
• 再讓它修改一個(gè)模塊。
• 然后運(yùn)行相關(guān)測試。
• 最后讓它 review 自己的 diff。

這和人類工程師協(xié)作一樣：任務(wù)越清晰，返工越少。

4. 忘記用 Git 兜底

Codex 會(huì)改文件、跑命令，但最終還是應(yīng)該用 Git 管理風(fēng)險(xiǎn)。開始大任務(wù)前先確認(rèn)工作區(qū)：

git status

完成后看 diff：

git diff

如果你讓 Codex 做較大改動(dòng)，最好每個(gè)階段都 review 一次，不要等幾百行 diff 堆在一起。

我的推薦 prompt 模板

代碼修復(fù)

修復(fù)這個(gè)問題：<問題描述>
要求：
1. 先定位根因并簡要說明。
2. 只修改必要文件。
3. 補(bǔ)充或更新相關(guān)測試。
4. 運(yùn)行最小必要驗(yàn)證命令。
5. 最后匯報(bào)修改文件、驗(yàn)證結(jié)果和殘余風(fēng)險(xiǎn)。

代碼審查

請 review 當(dāng)前未提交改動(dòng)。
只關(guān)注：
1. 真實(shí) bug
2. 行為回歸
3. 安全風(fēng)險(xiǎn)
4. 缺失測試
不要給風(fēng)格建議，除非它會(huì)導(dǎo)致明確問題。

項(xiàng)目接手

請閱讀當(dāng)前倉庫，不要修改文件。
輸出：
1. 項(xiàng)目用途
2. 技術(shù)棧
3. 入口文件
4. 主要模塊
5. 本地啟動(dòng)命令
6. 測試和構(gòu)建命令
7. 你建議寫入 AGENTS.md 的項(xiàng)目規(guī)則

重構(gòu)

重構(gòu) <模塊/文件>。
目標(biāo)：
1. 保持外部行為不變。
2. 降低重復(fù)邏輯。
3. 不引入新依賴。
4. 保留或補(bǔ)充測試覆蓋。
請先給計(jì)劃，等我確認(rèn)后再改。

什么時(shí)候 Codex CLI 更適合我

遷移后，我發(fā)現(xiàn) Codex CLI 特別適合這些場景：

• 本地倉庫里的連續(xù)開發(fā)任務(wù)。
• 需要讀多個(gè)文件、改代碼、跑測試的工程任務(wù)。
• 需要嚴(yán)格權(quán)限控制和可審計(jì)操作記錄的場景。
• 需要把團(tuán)隊(duì)規(guī)范固化到 AGENTS.md 的項(xiàng)目。
• 需要用 codex exec 做半自動(dòng)化腳本的任務(wù)。
• 需要在終端里快速 review 當(dāng)前 diff。

如果只是隨便問一個(gè)概念，網(wǎng)頁聊天也可以；但只要任務(wù)和本地代碼、命令、測試、文件修改有關(guān)，我會(huì)優(yōu)先打開 Codex CLI。

結(jié)語

這次遷移一開始是被動(dòng)的：Anthropic 賬戶被封，原來的 Claude Code 工作流突然中斷。但真正遷到 Codex CLI 后，我反而更重視“把 AI 編碼代理工程化”這件事。

我的核心經(jīng)驗(yàn)是：

• 把長期規(guī)則寫進(jìn) AGENTS.md。
• 把個(gè)人偏好寫進(jìn) ~/.codex/AGENTS.md。
• 把權(quán)限、模型、搜索和推理強(qiáng)度寫進(jìn) ~/.codex/config.toml。
• 用小任務(wù)驅(qū)動(dòng) Codex，而不是一次性扔大需求。
• 每次修改后讓 Codex 跑測試、做 review，再用 Git 檢查 diff。

Claude Code 更像一個(gè)順手的編碼搭檔；Codex CLI 更像一個(gè)可以被配置、約束和集成進(jìn)工程流程的本地代理。遷移成本不高，但要用好它，關(guān)鍵不是換一個(gè)命令，而是把工作流從“臨時(shí)聊天”升級(jí)成“可復(fù)用的工程協(xié)作系統(tǒng)”。

以上就是Claude Code一鍵遷移到Codex的完整流程與技巧的詳細(xì)內(nèi)容，更多關(guān)于Claude Code遷移到Codex的資料請關(guān)注腳本之家其它相關(guān)文章！