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 添加到版本控制中