結論先說
- 先認清出處:它是社區作者根據 Karpathy 公開帖子整理的四條行為指令(先想後寫、簡單優先、外科手術式修改、目標驅動執行),不是官方插件,也不含任何可執行魔法代碼。
- Codex 不預設讀
CLAUDE.md,直接搬進 Codex 有兩條正路:寫進AGENTS.md,或放進.agents/skills目錄當技能。 - 想每次會話自動約束 Codex,放全局
~/.codex/AGENTS.md或倉庫AGENTS.md;注意合併上限預設 32 KiB,別和倉庫原有規則打架。 - 只想在啃複雜重構時才啟用、平時改小文案不想被它反問拖慢,就放進
$HOME/.agents/skills/karpathy-guidelines/SKILL.md,需要時輸入$karpathy-guidelines點名觸發。 - 用前先把原文通讀一遍,它明確寫着「偏向謹慎而非速度」,會導致對話輪數變多。

圖:本站根據 andrej-karpathy-skills 倉庫 與 Codex 官方文檔整理的示意圖
本文根據社區倉庫forrestchang/andrej-karpathy-skills與 Codex 官方文檔《Custom instructions with AGENTS.md》《Build skills》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。該倉庫為第三方社區項目,非 OpenAI 或 Karpathy 官方發佈;本站(bigolab.com)不是 OpenAI 官方網站。Claude Code 下的用法見 Karpathy 的 CLAUDE.md 怎麼使用。
適用於誰
- 搜「codex 使用 andrej karpathy skills」,想把網上熱傳的四條編碼原則裝進 Codex 的開發者;
- 用 Codex 改代碼時,煩透了它「改一處順手重構十處」「不問清楚假設就硬寫幾百行」的人;
- 拿不準這份準則在 Codex 裏該直接塞進
AGENTS.md,還是裝進.agents/skills當技能調用的人。
一、這四條準則到底約束 Codex 什麼
社區倉庫把大模型寫代碼的常見通病總結成四條短規則(背景拆解詳見 Karpathy 的 CLAUDE.md 怎麼使用,本文只提煉對 Codex 生效的核心動作):
- Think Before Coding(先想後寫):需求有歧義或存在多種解釋時停下來列出來問,不悄悄替你選一種假設一路狂奔。
- Simplicity First(簡單優先):只寫解決當前問題最少的代碼,不擅自加配置項、抽象層或沒要求的擴展接口。
- Surgical Changes(外科手術式修改):只動任務直接涉及的代碼行,不順手格式化隔壁函數、不亂刪自己沒看懂的舊註釋;只清理自己這次改動留下的無用導入。
- Goal-Driven Execution(目標驅動執行):動手前先把模糊指令轉成可驗證指標(例如先寫復現單測再改代碼,跑通才算完)。
二、放法一:寫進全局或項目的 AGENTS.md(每輪常駐生效)
Codex 啟動會話時會按固定順序構建指令鏈:先讀全局 ~/.codex/AGENTS.md,再從 Git 倉庫根目錄逐級讀到當前啟動目錄(讀取規則詳見 Codex 怎麼讀 AGENTS.md)。
- 做成個人全局底線(推薦個人開發者):打開原倉庫裏的規則正文,去掉僅針對其他工具的標題說明,儲存或追加到
~/.codex/AGENTS.md(Windows 原生環境即用戶文件夾下.codex\AGENTS.md)。這樣本機所有倉庫都會繼承這四條習慣,又不污染團隊 Git 提交。 - 做成倉庫共享規範:如果全組都認同「禁止順手重構相鄰代碼」,就追加到倉庫根目錄的
AGENTS.md提交進版本庫。若某個實驗子目錄需要放開手腳大改,可在該子目錄放一份AGENTS.override.md局部覆蓋。 - 驗證有沒有讀進去:儲存後重開會話,或在終端執行官方檢查命令:
bash
codex --ask-for-approval never "List the instruction sources you loaded."
確認輸出裏包含你剛編輯的那份 AGENTS.md,且總合並體積沒有超過 project_doc_max_bytes(預設 32768 字節)。

圖:本站根據 Codex 官方文檔:AGENTS.md 與《Build skills》整理的示意圖
三、放法二:放進 .agents/skills 做成按需技能(更省上下文與輪數)
原倉庫除了根目錄規則文件,還提供了符合開放技能規範的 skills/karpathy-guidelines/SKILL.md。按 Codex 官方《Build skills》文檔(完整用法見 Codex Skills 怎麼用),把技能文件夾放到以下任一掃描位置即可直接複用:
- 個人跨倉庫使用:
$HOME/.agents/skills/karpathy-guidelines/SKILL.md - 當前倉庫團隊共享:
<倉庫根目錄>/.agents/skills/karpathy-guidelines/SKILL.md
放成 Skill 有兩個明顯好處:
- 平時不佔正文上下文:Codex 啟動時只加載技能的
name和簡短description(技能目錄總預算預設不超過上下文窗口的 2%),只有啟用該技能時才讀取完整SKILL.md。 - 開關自如,不拖慢簡單小活:如果你不想讓它在改一行拼寫錯誤時也反覆跟你核對假設,可以在該技能目錄下新建
agents/openai.yaml關閉隱式自動觸發:
yaml
policy:
allow_implicit_invocation: false
這樣平時寫小腳本完全不受影響;遇到複雜老代碼修改時,在 CLI 或 IDE 擴展輸入框敲 $karpathy-guidelines(或輸 /skills 選擇)顯式掛載即可。若某段時間完全不想看到它,還可在 ~/.codex/config.toml 裏用 [[skills.config]] 把 enabled 設為 false。
四、使用注意事項與額度影響
- 安裝前先做安全審閱:任何第三方倉庫的規則和技能文件都會直接注入模型提示詞,複製或更新前請先肉眼通讀一遍全文,養成審查習慣(見 Skill 安全嗎:安裝前檢查什麼)。
- 清理衝突指令:如果你的項目
AGENTS.md原本寫着「看到壞味道順手重構」,會與第三條「外科手術式修改」直接衝突,合併前要刪掉一頭。 - 留意多輪對話額度:由於準則要求「先提問澄清、先寫測試再改並循環驗證」,單個任務的交互輪次會比一言不發直接改代碼更多。若用 ChatGPT Plus 跑重度倉庫感覺 5 小時額度吃緊,可查看本站 ChatGPT Plus 充值說明 或無 5 小時限制的 ChatGPT Pro 充值說明。
常見問題
問:能不能直接讓 Codex 自動讀項目裏已有的 CLAUDE.md,省得複製兩份?
答:可以。Codex 的 config.toml 提供了 project_doc_fallback_filenames 備用文件名數組(例如設為 ["CLAUDE.md"]),當某層目錄沒有 AGENTS.md 時就會按順序回退讀取 CLAUDE.md。
問:在 Codex 裏敲 /plugin 能像 Claude Code 那樣直接裝原倉庫插件嗎?
答:兩家的插件打包規範不同,原倉庫的 Claude Code 插件市場命令不直接照搬到 Codex;在 Codex 裏最乾淨、零依賴的做法就是複製 SKILL.md 到 .agents/skills 或寫進 AGENTS.md。
問:加了這份準則後,Codex 就絕對不會亂改無關代碼了嗎?
答:不會百分之百保證。無論 AGENTS.md 還是 SKILL.md 本質都是上下文提示詞而非沙箱硬鎖,改完後仍建議敲 /diff 檢查實際改動範圍。
相關教學
參考資料
- GitHub 倉庫:forrestchang/andrej-karpathy-skills — https://github.com/forrestchang/andrej-karpathy-skills
- Codex 官方文檔:Custom instructions with AGENTS.md — https://learn.chatgpt.com/docs/agent-configuration/agents-md
- Codex 官方文檔:Build skills — https://learn.chatgpt.com/docs/build-skills
0 條評論
還沒有評論,來搶沙發~