Boris Cherny: How We Built Claude Code

Target frontier capabilities, not current limitations

Cherny advises founders to build for where models will be in six months, as capabilities improve rapidly. Claude Code was architected assuming models would eventually excel at coding tasks they initially performed poorly.

Aggressive rewriting over code preservation

The entire codebase has been rewritten multiple times over six months as capabilities evolved, with no original code remaining. This reflects a willingness to discard work as model capabilities make old scaffolding obsolete.

Plan mode obsolescence timeline

Cherny predicts explicit planning modes may become unnecessary within a month as models become capable of autonomous reasoning without structured prompting or explicit instructions.

Terminal as constraint, not strategy

The CLI form factor emerged accidentally because it required no UI development, not from strategic planning. This constraint became a strength, making the tool accessible without requiring knowledge of Vim, Tmux, or complex IDE configurations.

Users reveal needs through behavior

The team discovered latent demand by observing engineers creating markdown instruction files for the model, which evolved into the formal Claude MD feature rather than being designed top-down.

Organic viral adoption

Internal usage charts showed vertical growth without mandates—engineers shared the tool virally after Boris posted about it, with colleagues adopting it immediately despite prototype status.

Shared context over personal prompts

Cherny maintains a minimal two-line personal Claude MD, storing all instructions in a shared codebase file that the team updates multiple times weekly, treating AI mistakes as opportunities to improve collective documentation.

Verbosity as debuggability feature

Attempts to summarize bash output faced user revolt because developers need transparency to catch when models go wrong, leading to configurable verbosity modes rather than forced brevity.

Delete and restart approach

When Claude MD grows too large, Cherny recommends deleting it entirely and starting fresh, adding back only what the new model strictly requires, as older scaffolding becomes unnecessary with capability advances.