setup-engine

To pin an engine version in CLAUDE.md, run a guided engine setup process that locks the selected engine and version into your project configuration files. This ensures version consistency across your Claude Code projects.

Refreshing engine reference docs is best handled by automating WebSearch lookups for the latest stable versions. The process detects when your pinned version exceeds the model's training data and automatically populates the updated documentation.

You need to update engine configuration documentation when the chosen engine version falls beyond the model's training data. This knowledge-gap detection triggers a documentation refresh to keep your technical preferences and reference docs current.

Yes, you can upgrade engine versions automatically during project maintenance by using guided upgrade paths. The process parses arguments, selects the target engine, and updates the configuration alongside the reference docs.

Engine setup works during both project initialization and maintenance, meaning it can establish the necessary configuration entries in CLAUDE.md even if you are starting a new project without existing config files.

CLAUDE.md needs version-pinning to synchronize versioned configuration across your project. Locking the engine version prevents unexpected updates and ensures the model uses the correct technical reference.