标题: Claude Code /init 命令深度源码解析：从输入到 CLAUDE.md 生成的完整链路
作者: #manbaout
板块: #开发调优
编号: 1930438
帖子: https://linux.do/t/topic/1930438
时间: 2026-04-09 15:12:00
摘要:

前言
当我们首次在一个项目中使用 Claude Code 时，第一件事通常是输入 /init。这个命令会自动分析你的代码库，生成一个 CLAUDE.md 文件——它是 Claude Code 理解你项目的"记忆锚点"，后续每次对话都会自动加载。
但 /init 到底做了什么？它只是一条简单的提示词，还是背后有复杂的工程机制？本文将沿着源码调用链，从用户输入 /init 的那一刻起，追踪到 CLAUDE.md 文件被写入磁盘、再到被加载进每次会话的完整过程。

一、全局视角：调用链总览
先给出完整的调用链路图，后面逐一拆解：
用户输入 "/init"
      │
      ▼
processSlashCommand.tsx ──→ 匹配 Command 对象
      │
      ▼
init.ts: getPromptForCommand() ──→ 返回 Prompt 文本
      │
      ├── OLD_INIT_PROMPT (经典模式)
      └── NEW_INIT_PROMPT (新版 8 阶段模式)
      │
      ▼
Prompt 作为 user message 发送给 Claude API
      │
      ▼
Claude 使用工具探索代码库（Read/Glob/Grep/AskUserQuestion...）
      │
      ▼
Claude 调用 FileWriteTool 写入 CLAUDE.md
      │
      ├── 记录 tengu_write_claudemd 分析事件
      └── maybeMarkProjectOnboardingComplete() 标记引导完成
      │
      ▼
下次会话启动时：
context.ts: getUserContext()
      │
      ▼
claudemd.ts: getMemoryFiles() ──→ 多层级文件发现
      │
      ▼
claudemd.ts: getClaudeMds() ──→ 拼接为系统提示注入 Claude


二、命令注册：/init 从哪里来？
2.1 命令定义
/init 是一个 type: 'prompt' 类型的命令，定义在 src/commands/init.ts:226-256：
// src/commands/init.ts:226-256
const command = {
  type: 'prompt',
  name: 'init',
  get description() {
    return feature('NEW_INIT') &&
      (process.env.USER_TYPE === 'ant' ||
        isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
      ? 'Initialize new CLAUDE.md file(s) and optional skills/hooks with codebase documentation'
      : 'Initialize a new CLAUDE.md file with codebase documentation'
  },
  contentLength: 0,
  progressMessage: 'analyzing your codebase',
  source: 'builtin',
  async getPromptForCommand() {
    maybeMarkProjectOnboardingComplete()
    return [
      {
        type: 'text',
        text:
          feature('NEW_INIT') &&
          (process.env.USER_TYPE === 'ant' ||
            isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
            ? NEW_INIT_PROMPT
            : OLD_INIT_PROMPT,
      },
    ]
  },
} satisfies Command

几个关键点：

type: 'prompt' — 这是理解 /init 本质的关键。它不是一个本地执行命令（type: 'local'），而是一个提示词命令。它的 getPromptForCommand 返回的文本会被当作 user message 发送给 Claude API
contentLength: 0 — 表示命令本身不携带用户输入的额外内容（/init 后面通常不跟参数）
progressMessage: 'analyzing your codebase' — 用户在等待时看到的提示文字
Feature flag 分支 — 通过 feature('NEW_INIT') 控制使用哪套 Prompt

2.2 命令注册
src/commands.ts 中完成了 init 命令的注册：
// src/commands.ts:25
import init from './commands/init.js'

// src/commands.ts:282（在 COMMANDS 数组中）
const COMMANDS = memoize((): Command[] => [
  // ... 其他命令
  init,
  // ...
])

COMMANDS 数组用 memoize 包装——因为底层函数需要读取配置，不能在模块初始化阶段执行。所有命令（内置 + 技能 + 插件 + 工作流）最终通过 getCommands() 合并后对外暴露。
2.3 Command 类型系统
来看 PromptCommand 的类型定义（src/types/command.ts:25-57）：
// src/types/command.ts:25-57
export type PromptCommand = {
  type: 'prompt'
  progressMessage: string
  contentLength: number
  argNames?: string[]
  allowedTools?: string[]
  model?: string
  source: SettingSource | 'builtin' | 'mcp' | 'plugin' | 'bundled'
  disableNonInteractive?: boolean
  hooks?: HooksSettings
  skillRoot?: string
  context?: 'inline' | 'fork'
  agent?: string
  effort?: EffortValue
  paths?: string[]
  getPromptForCommand(
    args: string,
    context: ToolUseContext,
  ): Promise<ContentBlockParam[]>
}

getPromptForCommand 是核心方法 — 它返回 ContentBlockParam[]，这是 Anthropic SDK 定义的消息内容块类型。返回的内容会被包装成 user message 发送给 Claude 模型。

三、Prompt 内容：两套策略
/init 的核心是它的 Prompt 文本。当前有两个版本：
3.1 经典模式（OLD_INIT_PROMPT）
src/commands/init.ts:6-26，仅 20 行，简单直接：
// src/commands/init.ts:6-26
const OLD_INIT_PROMPT = `Please analyze this codebase and create a CLAUDE.md file,
which will be given to future instances of Claude Code to operate in this repository.

What to add:
1. Commands that will be commonly used, such as how to build, lint, and run tests.
   Include the necessary commands to develop in this codebase, such as how to run
   a single test.
2. High-level code architecture and structure so that future instances can be
   productive more quickly. Focus on the "big pictur

标题: GPT抽了，你们遇到了吗
作者: #cxymds
板块: #搞七捻三
编号: 1930450
帖子: https://linux.do/t/topic/1930450
时间: 2026-04-09 15:13:53
摘要:

发生了什么事

标题: 博士课题要使用PBWT + HMM算法写一个MAGIC群体重组位点检测的软件，但是现在一点动力也没有怎么办
作者: #luelueluelue
板块: #搞七捻三
编号: 1930451
帖子: https://linux.do/t/topic/1930451
时间: 2026-04-09 15:14:21
摘要:

最近一直一直在摆烂，但其我都又对单细胞这样的分析没有抵触，就对这个PBWT + HMM算法很烦很烦

标题: 昨天晚上睡觉，梦到了一个绝妙的创意。
作者: #毛球球
板块: #搞七捻三
编号: 1930452
帖子: https://linux.do/t/topic/1930452
时间: 2026-04-09 15:14:37
摘要:

等着吧，我将颠覆整个互联网。
v1.0已经在构思中了，等我完全vibecoding下来，就找始皇拉赞助。
话说，我今天上午无聊开发的开源项目，怎么一个小时了还在审核中。

标题: CPA中GPT5.4开始频繁Stream disconnected before completion 笨蛋解决方法
作者: #hefeng
板块: #开发调优
编号: 1930466
帖子: https://linux.do/t/topic/1930466
时间: 2026-04-09 15:17:00
摘要:

问题：
 Stream disconnected before completion: An error occurred while processing your request. You can retry your
    request, or contact us through our help center at help.openai.com if the error persists. Please include the
    request ID 12627365-eedc-44eb-8788-2c6588dc02fa in your message.

如果不想新开对话，就在当前对话回答一句类似 当前工作都已经完成了吗，以进行重试，重试仍失败时revert到这一句重新重试，直到可以继续

标题: 设置默认回复显示样式
作者: #城里来的乡下人
板块: #运营反馈
编号: 1930498
帖子: https://linux.do/t/topic/1930498
时间: 2026-04-09 15:21:12
摘要:

能否在设置中更改默认的回复显示样式, 喜欢以树状显示回复, 但每个帖子都要手动切换

标题: 有没有并排开多个终端的工具
作者: #huangmo
板块: #开发调优
编号: 1930511
帖子: https://linux.do/t/topic/1930511
时间: 2026-04-09 15:22:46
摘要:

如题 有没有并排开多个终端的工具，我想同时开多个CC使用
谢谢大佬们！