AiCodeCat Docs

主题

7.1 /init - 初始化命令 ​

概述 ​

/init 命令是 Claude Code 的核心命令，用於初始化專案知識圖譜。它會掃描目前資料夾下的所有檔案，將解析結果儲存到 CLAUDE.md 檔案中，為後續對話提供完整的專案上下文。

基本語法 ​

/init

功能說明 ​

執行 /init 命令後，Claude Code 會：

  1. 掃描目前目錄下的所有檔案
  2. 解析檔案內容並生成專案知識圖譜
  3. 將解析結果儲存到 CLAUDE.md 檔案中
  4. 後續對話會自動引用該檔案作為上下文

使用場景 ​

1. 新專案初始化 ​

當你首次在專案中使用 Claude Code 時，建議先執行 /init 命令，讓 AI 全面了解專案結構和程式碼。

bash
# 在專案根目錄執行初始化
/init

2. 專案檔案更新後重新初始化 ​

當專案檔案結構或關鍵程式碼發生較大變化時，可以再次執行 /init 命令，更新 CLAUDE.md 檔案，確保 AI 擁有最新的專案上下文。

bash
# 更新專案知識圖譜
/init

關鍵特點 ​

  1. 生成 CLAUDE.md 檔案：該檔案包含專案所有檔案的解析結果，是 AI 理解專案的核心依據
  2. 支援手動編輯：你可以直接修改 CLAUDE.md 檔案，新增框架說明、專案架構或其他重要資訊
  3. 自動作為上下文：後續與 Claude Code 的對話會自動引用 CLAUDE.md 檔案，無需手動指定
  4. 提升對話效率：有了完整的專案上下文，AI 能更準確地理解你的問題和需求

注意事項 ​

  • /init 命令不會修改或建立除 CLAUDE.md 外的任何檔案
  • 大型專案可能需要較長時間來完成掃描和解析
  • 建議定期更新 CLAUDE.md 檔案，尤其是在專案結構發生重大變化後
  • CLAUDE.md 檔案可以新增到 .gitignore 中，避免不必要的版本控制

與其他命令的配合使用 ​

bash
# 初始化專案知識，然後開始新的對話
/init
/clear

# 執行流程：
# 1. 生成 CLAUDE.md 檔案，包含完整專案上下文
# 2. 清空歷史對話，開始全新的對話
# 3. 新對話會自動使用 CLAUDE.md 作為上下文

最佳實踐 ​

  1. 新專案必用：在任何新專案中首次使用 Claude Code 時，先執行 /init
  2. 定期更新：當專案檔案發生較大變化時，重新執行 /init
  3. 手動補充：根據需要手動編輯 CLAUDE.md，新增 AI 可能需要的額外資訊
  4. 合理管理：根據專案大小和需求，決定是否將 CLAUDE.md 新增到版本控制中