Claude Code 用 /init 生成與維護項目 CLAUDE.md:掃描內容、生成後必改項與誤區

Claude Code 裏的 /init 命令到底掃了哪些文件、已有 CLAUDE.md 時會不會直接覆蓋?本文按官方文檔拆解 /init 的掃描範圍、CLAUDE_CODE_NEW_INIT 交互模式、生成後必刪必補的四項內容與三個常見誤區。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. /init 是自動掃描代碼庫生成起始 CLAUDE.md 的引導命令:它會讀取包管理配置、構建腳本、目錄結構以及已有的 Cursor / Copilot 規則文件,彙總出一份項目指令初稿。
  2. 已有 CLAUDE.md 時不會粗暴覆蓋:如果根目錄已經存在該文件,/init 會對比當前代碼庫審閱舊內容,向你提出增刪改進建議並等待確認。
  3. 生成完第一件事不是提交,而是刪減:官方建議單份 CLAUDE.md 控制在 200 行以內;凡是 Claude 讀代碼自己就能看懂的目錄列表和通用常識都該刪掉。
  4. 不要每次開新會話都跑一遍 /init:生成好的 CLAUDE.md 以後每次啟動都會自動加載,反覆跑 /init 只會白白消耗掃描代碼庫的大量 Token。
  5. Claude Code 訂閱與高配額開通入口:國內無境外卡可通過本站 iOS 免上號自助卡密開通 Claude Pro 會員 或 5 倍以上額度的 Claude Max 會員,完整檔位選型見 Claude Code 訂閱說明頁。

用 /init 初始化與瘦身四步法

圖:本站根據 Claude Code 官方文檔:How Claude remembers your project 整理的示意圖

本文根據 Claude Code 官方文檔《How Claude remembers your project》《Best practices for Claude Code》《Commands》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。

適用於誰

  • 搜「claude code /init 命令」「/init 生成 claude.md」,想知道敲下這條斜槓命令後它在後台讀了什麼、改了什麼的人;
  • 倉庫裏本來已經有了一份手寫的 CLAUDE.md 或 .cursorrules,擔心運行 /init 會把舊規則直接清空覆蓋的開發者;
  • 運行完 /init 得到兩三百行說明後直接提交進倉庫,結果發現每次對話額度掉得飛快、指令遵循度反而下降的人。

如果你剛接手一個陌生遺留工程,想看從只讀摸底到小步重構的完整接手流程,可配合閱讀 Claude Code 接手老項目:先讀懂代碼庫、用 /init 生成 CLAUDE.md。

一、敲下 /init 後,Claude Code 到底掃描了什麼

進入項目根目錄啟動 claude,在輸入框敲入 /init 回車後,智能體會發起一輪只讀探索循環,重點採集三類資訊:

  1. 構建、測試與檢查腳本:讀取 package.json、pyproject.toml、Cargo.toml、Makefile、Dockerfile 以及 .github/workflows 等流水線配置,提取安裝依賴、本地啟動、類型檢查和運行單元測試的準確命令。
  2. 目錄分工與核心鏈路:抽樣查看 README.md 與 src/ 頂層模組入口,總結前後端分層、數據庫 ORM 位置或路由約定。
  3. 已有其他 AI 工具的規則資產:官方文檔說明,如果倉庫裏已經配過 Cursor 規則(.cursor/rules/ 或 .cursorrules)或 GitHub Copilot 指令(.github/copilot-instructions.md),/init 會主動讀取並把適用的項目約束吸納進生成的草稿裏。

如果你想在初始化時順帶引導配置技能(Skills)和鉤子(Hooks),官方還提供了新版交互式開關:先在終端設定環境變量 CLAUDE_CODE_NEW_INIT=1 再啟動運行 /init,它會分階段詢問你要創建哪些項目配置。

二、生成草稿後必做的四項人工精修

/init 生成內容留與刪判斷表

圖:本站根據 Claude Code 官方文檔:Best practices for Claude Code 整理的示意圖

機器自動總結的初稿往往偏囉嗦,直接留着用每輪對話都會帶着幾千字背景計費。參考各技術棧成稿結構(詳見 Claude Code 的 CLAUDE.md 模板:前端、後端、數據分析),按下面四條動手改一遍:

  1. 核准「只跑單個測試文件」的命令:/init 常只寫出跑全量測試的 npm test,全量跑一次要幾分鐘。務必改成支持傳入單文件路徑的命令(例如 npx vitest run src/auth.test.ts 或 pytest tests/test_order.py -k test_pay),讓智能體每次小步改完能秒級自檢。
  2. 大刀砍掉目錄樹和框架套話:官方給出的去留標準很簡單——「刪掉這一行,Claude 會不會犯錯?」像「src/components 存放前端組件」「使用 TypeScript 編寫類型安全的代碼」這類廢話一律刪掉。
  3. 補上代碼裏看不出來的「坑」:重點寫進倉庫歷史包袱,例如「src/api/v1 是廢棄兼容層只修不增,新接口一律寫在 src/api/v2」「改數據庫表結構禁止直接手改舊遷移文件」。
  4. 把個人習慣和局部規則拆出去:你個人的中文回覆偏好、提交資訊格式放進用戶級 ~/.claude/CLAUDE.md(分工見 全局 CLAUDE.md 怎麼配);只針對某幾個子模組的細則挪進 .claude/rules/ 目錄並用 paths: 限定觸發路徑。

三、關於 /init 與日常維護的三個常見誤區

  • 誤區一:完全空白的新文件夾先跑 /init。空目錄裏沒有任何配置文件可供推斷,跑出來全是空泛模板。正確順序是先用腳手架(如 create-next-app 或 uv init)搭好工程骨架、裝好測試框架,再執行 /init。
  • 誤區二:以為 CLAUDE.md 會隨着你平時改代碼自動同步更新。CLAUDE.md 是靜態指令文件,不會在普通對話裏自己改寫(它與自動記憶 MEMORY.md 的本質區別見 CLAUDE.md 會自動更新嗎、怎麼更新)。只有當你大改了構建工具或目錄架構時,才需要再跑一次 /init 讓它對照現狀提修訂建議。
  • 誤區三:把幾千字業務需求文檔全塞進 CLAUDE.md。長篇接口契約和歷史設計稿應單獨放在 docs/ 目錄,在 CLAUDE.md 裏只留一行路徑指引讓模型按需讀取。

把根目錄 CLAUDE.md 精簡到百行左右後,不僅指令命中率更高,每次會話的固定上下文底噪也會明顯下降,能讓個人訂閱的 5 小時滾動額度耐用不少;日常需要開通或續訂官方訂閱可查看本站 Claude Code 充值頁 或 Claude Pro 方案。

常見問題

問:倉庫裏已經有同事維護好的 AGENTS.md,還要用 /init 重新生成一份嗎?

答:不需要重寫兩套。可以讓 CLAUDE.md 用 @AGENTS.md 語法直接導入共享規範,再在下面只補幾行 Claude Code 專屬工具或鉤子說明即可。

問:怎麼檢查我的 CLAUDE.md 裏有沒有寫過期失效的文件路徑?

答:在會話裏輸入 /memory 可以核對當前加載了哪幾份記憶文件;遇到規則臃腫或疑似前後矛盾時,也可以直接發提示詞讓 Claude 對照最新目錄結構審查一遍 CLAUDE.md 裏的失效路徑。

問:/init 生成的文件應該提交進 Git 還是加進 .gitignore?

答:根目錄 ./CLAUDE.md 面向全團隊共享,應當提交進 Git;只屬於你個人的本地調試備註請單獨建 ./CLAUDE.local.md 並加進 .gitignore。

問:國內沒有海外銀行卡,怎麼給 Claude Code 開通 Pro 或 Max 訂閱?

答:可在 Claude Code 訂閱頁 選擇走 iOS 訂閱鏈路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付寶、微信支付與 AlipayHK,無需交出帳號密碼;若帳號彈出身份核驗也可查看 Claude KYC 認證人工協助(失敗不收費,封號不在質保範圍)。

相關教學

參考資料

  • Claude Code 官方文檔:How Claude remembers your project — https://code.claude.com/docs/en/memory
  • Claude Code 官方文檔:Best practices for Claude Code — https://code.claude.com/docs/en/best-practices
  • Claude Code 官方文檔:Built-in commands(/init 說明) — https://code.claude.com/docs/en/commands

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~