Claude Code /init 命令使用指南：什么时候该用它？

在使用 Claude Code 进行开发时，很多人会忽略一个非常关键的命令：/init。

它看起来只是一个初始化操作，但实际上，它直接影响 AI 对你项目的理解深度和后续代码生成质量。

这篇文章我们就来讲清楚：/init 到底是什么？什么时候必须用？什么时候可以不用？

---

一、什么是 /init？

/init 的核心作用是：

👉 让 Claude Code“理解你的项目上下文”

执行后，Claude Code 会：

• 扫描当前目录结构
• 识别项目类型（Node.js / Python / Go 等）
• 分析关键文件（如 package.json、requirements.txt 等）
• 构建一个内部上下文（Context）

你可以把它理解为：

给 AI 做一次“项目 onboarding”

---

二、为什么 /init 很重要？

默认情况下，Claude Code 是“无上下文”的。

也就是说：

• 它不知道你的项目是干什么的
• 不知道你用什么框架
• 不知道代码组织结构

👉 结果就是：

• 生成代码容易“风格跑偏”
• 修改代码可能破坏现有结构
• 回答问题缺乏针对性

而 /init 可以解决这些问题：

能力	说明
项目感知	知道你是 Web / CLI / 微服务
技术栈识别	React / FastAPI / Spring 等
代码一致性	生成代码更贴合现有风格
更精准修改	避免“瞎改代码”

---

三、什么时候必须使用 /init？

以下场景建议一定要执行 /init：

---

1️⃣ 第一次进入一个项目

👉 最典型场景

cd my-project
claude
/init

原因：

• AI 完全不知道你的项目结构
• 不初始化 = “盲写代码”

---

2️⃣ 切换项目 / 仓库

例如：

• 从 backend-service 切到 frontend-app
• 从 monorepo 的一个子模块切到另一个

👉 必须重新 /init

否则：

• AI 仍然使用旧项目的上下文（容易出错）

---

3️⃣ 项目结构发生重大变化

例如：

• 重构目录结构
• 引入新框架（如从 Express → NestJS）
• 大规模文件新增/删除

👉 建议重新 /init

因为：

• 原有 context 已经过时

---

4️⃣ AI 开始“胡说八道”时 🤨

一些典型信号：

• 推荐不存在的文件路径
• 用错框架 API
• 忽略已有代码结构

👉 这通常意味着：

上下文失效了 → 重新 /init

---

四、什么时候可以不用 /init？

并不是每次都要跑 /init，以下情况可以跳过：

---

✅ 1️⃣ 同一会话内持续开发

只要：

• 没换目录
• 项目没大改

👉 不需要重复 /init

---

✅ 2️⃣ 做简单、无上下文任务

比如：

• 写一个独立函数
• 解释语法
• 做算法题

👉 这些不依赖项目结构

---

✅ 3️⃣ 小规模文件修改

例如：

• 改一个 bug
• 加一个函数

👉 一般上下文还有效

---

五、最佳实践（非常重要）

这里给你一套高效使用 Claude Code 的工作流👇

---

🚀 推荐流程

# 1. 进入项目
cd my-project

# 2. 初始化上下文
/init

# 3. 开始开发
"帮我给这个项目加一个登录功能"

# 4. 如果出现异常
/init   # 重新初始化

---

💡 实战建议

✔ 定期刷新上下文

• 长时间开发后，建议重新 /init
• 避免 context “漂移”

---

✔ 配合明确指令

例如：

在当前 FastAPI 项目中新增一个 JWT 登录接口

👉 比“写个登录功能”效果好很多

---

✔ 和代码浏览结合使用

先让 Claude：

• “总结项目结构”
• “解释某个模块”

再让它改代码

👉 效果更稳

---

六、常见误区

---

❌ 误区 1：把 /init 当可选项

现实情况：

❗ 在真实项目中，它几乎是“必需步骤”

---

❌ 误区 2：频繁无脑 /init

问题：

• 浪费时间
• 没有实际收益

👉 应该“按需使用”

---

❌ 误区 3：以为 /init = 训练模型

不是的：

• 它只是构建当前会话上下文
• 不会改变模型本身

---

七、总结

一句话总结 /init：

👉 它不是命令，而是 Claude Code 的“项目记忆开关”

---

使用时机速查表

场景	是否需要 /init
新项目	✅ 必须
切换仓库	✅ 必须
大规模重构	✅ 建议
AI输出异常	✅ 强烈建议
小修改	❌ 不需要
算法/独立代码	❌ 不需要

---

如果你在实际使用 Claude Code 时，经常遇到：

• 代码风格不一致
• AI 理解错误
• 修改“越改越乱”

👉 很大概率就是：你少了一次 /init