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

圖:本站根據 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 回車後,智能體會發起一輪只讀探索循環,重點採集三類資訊:
- 構建、測試與檢查腳本:讀取
package.json、pyproject.toml、Cargo.toml、Makefile、Dockerfile以及.github/workflows等流水線配置,提取安裝依賴、本地啟動、類型檢查和運行單元測試的準確命令。 - 目錄分工與核心鏈路:抽樣查看
README.md與src/頂層模組入口,總結前後端分層、數據庫 ORM 位置或路由約定。 - 已有其他 AI 工具的規則資產:官方文檔說明,如果倉庫裏已經配過 Cursor 規則(
.cursor/rules/或.cursorrules)或 GitHub Copilot 指令(.github/copilot-instructions.md),/init會主動讀取並把適用的項目約束吸納進生成的草稿裏。
如果你想在初始化時順帶引導配置技能(Skills)和鉤子(Hooks),官方還提供了新版交互式開關:先在終端設定環境變量 CLAUDE_CODE_NEW_INIT=1 再啟動運行 /init,它會分階段詢問你要創建哪些項目配置。
二、生成草稿後必做的四項人工精修

圖:本站根據 Claude Code 官方文檔:Best practices for Claude Code 整理的示意圖
機器自動總結的初稿往往偏囉嗦,直接留着用每輪對話都會帶着幾千字背景計費。參考各技術棧成稿結構(詳見 Claude Code 的 CLAUDE.md 模板:前端、後端、數據分析),按下面四條動手改一遍:
- 核准「只跑單個測試文件」的命令:
/init常只寫出跑全量測試的npm test,全量跑一次要幾分鐘。務必改成支持傳入單文件路徑的命令(例如npx vitest run src/auth.test.ts或pytest tests/test_order.py -k test_pay),讓智能體每次小步改完能秒級自檢。 - 大刀砍掉目錄樹和框架套話:官方給出的去留標準很簡單——「刪掉這一行,Claude 會不會犯錯?」像「
src/components存放前端組件」「使用 TypeScript 編寫類型安全的代碼」這類廢話一律刪掉。 - 補上代碼裏看不出來的「坑」:重點寫進倉庫歷史包袱,例如「
src/api/v1是廢棄兼容層只修不增,新接口一律寫在src/api/v2」「改數據庫表結構禁止直接手改舊遷移文件」。 - 把個人習慣和局部規則拆出去:你個人的中文回覆偏好、提交資訊格式放進用戶級
~/.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 接手老項目:先讀懂代碼庫、用 /init 生成 CLAUDE.md
- 全局 CLAUDE.md 怎麼配:~/.claude/CLAUDE.md 與項目指令分工
- CLAUDE.md 會自動更新嗎、怎麼更新:auto memory 和 CLAUDE.md 的區別
- Claude Code 的 CLAUDE.md 模板:前端、後端、數據分析各一份
參考資料
- 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
0 條評論
還沒有評論,來搶沙發~