7.1 /init - 初始化命令

概述

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

基本语法

bash


/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 新增到版本控制中