← sources

Is running /init is the right first interaction with a codebase?

source: reddit (reddit:ClaudeCode)published 2026-09-07 17:07ingested 2026-09-08 02:42

retained text

**1.** What claude \`/init\` does: It checks the code and writes a CLAUDE.md file with *what it can figure out by reading the code*.\*

**2.** Meanwhile [claude best practices](https://code.claude.com/docs/en/best-practices): what you should **NOT put in claude md** as the primary priority: *Anything Claude can figure out by reading code.*

*---*

🤔 I see some **mixed messages** there, Claude... especially with the cost of this \`/init\` with the created md file always getting included all over the place...

\---

My personal experience is that it's almost always just token bloat... (sure, could be a skill issue...) it will most likely depend on the structure of your repo. So it could be useful if your repo is the best fit ever, who knows. Is it worth the tokens? Who knows... Either way that guidance above is weird compared to a default functionality of the tool itself.

My most naive take probably would be that **the don't do it rule is about what you could from the structure with about 1-2 tool calls** (or probably by just grepping)... still unclear but might make sense to me. But then, I definitely have some CLAUDE md files is some repos which were created by claude \`/init\` having totally standard npm commands in them, which contradicts the primary no-no, and the secondary no-no from the docs.

\* - There is the option to do **interactive** \`/init\` (\`CLAUDE\_CODE\_NEW\_INIT=1\`), sure, that would help a lot to fill in gaps. But should all of that be part of CLAUDE md? Dunno, probably not...

\---

So please tell me about cases where running \`/init\` as the first interaction actually was (proven to be) useful... I have enough references for the cons. 🤔 But a good story is always welcome.

No AI was harmed while writing this, I just write like a spastic.

document fetched 2026-09-08 00:38 · canonical https://reddit.com/r/ClaudeCode/comments/1w9xy7k/is_running_init_is_the_right_first_interaction