前言¶

在使用 AI 編碼助手時，容易陷入過度設計、添加無關改動，或在沒有明確目標的情況下就開始寫代碼。這些習慣會增加維護成本，也讓代碼偏離初衷。Karpathy · CLAUDE 編碼四原則基於 Andrej Karpathy 對 LLM 編程常見缺陷的觀察，提供一套可在編碼過程中遵循的規範，幫助減少上述問題。

是什麼¶

Karpathy · CLAUDE 編碼四原則是一套編碼規範，核心是四項原則：先思考再編碼、簡單優先、精準修改、目標驅動。該規範由社區貢獻，版本 1.0.0，分類爲 dev-programming。它適用於 CodeBuddy、Claude Code、Cursor 等工具，幫助開發者在使用 AI 編碼助手時更加聚焦。

核心功能¶

該規範聚焦於編碼流程中的四個關鍵環節，通過明確步驟與原則，引導更合理的編碼行爲：

1. 先思考再編碼
   - 在動手寫代碼前，先明確要解決的問題、輸入與輸出、邊界條件與可能的異常。如果問題本身不清晰，不要開始寫代碼。

2. 簡單優先
   - 優先採用最簡單可解的方案，避免引入不必要的抽象或複雜設計。簡單方案更容易理解、測試與維護，也更符合 Karpathy 對 LLM 編程缺陷的觀察。

3. 精準修改
   - 修改代碼時，只針對需要改變的部分，避免一次性改動過多。每一次修改都應明確目標，並確認其不會引入新的問題。

4. 目標驅動
   - 所有編碼活動都應圍繞一個明確的目標展開。在執行過程中，定期對照目標進行校驗，確保偏離目標時及時糾正。

適用場景與注意¶

該規範適用於所有編程任務，尤其適合在以下場景中參考：

• 需要減少過度設計的重構或新功能開發
• 在 AI 編碼助手協作中需要明確行爲邊界
• 對代碼質量與可維護性有較高要求的場景

注意：該規範爲通用編碼原則，需結合具體項目需求與團隊約定使用。規範本身不提供工具安裝或配置字段，建議在編碼流程中將其作爲檢查清單或輔助參考。

總結¶

Karpathy · CLAUDE 編碼四原則通過四個明確原則，幫助開發者在使用 AI 編碼助手時減少過度設計、無關改動和假設性錯誤。在實際編碼過程中，將這四項原則作爲檢查點，可以更清晰地掌控代碼走向。

官方地址：https://api.skillhub.cn/user_e3e7ac34/karpathy-claude-four-principles