The handbook/CLAUDE.md Builder: Project Instructions for Beginners
Reading settingsMy workspaceOfficial docs ↗

Guided project instructions

Build your project’s
CLAUDE.md.

Create a CLAUDE.md file with project context, coding rules, security expectations, and verification steps. Edit, copy, or download your instructions.

INTERACTIVE BUILDER3 steps • No account required

CLAUDE.md is a plain-text instruction file for Claude Code. It helps you repeat fewer project rules. This builder asks for facts you know; you can leave unfamiliar fields blank.

Instructions are not a lock

CLAUDE.md guides behavior. It does not enforce tool permissions or make an application secure. Use actual access controls and verify the result. Never put passwords, tokens, or personal records in this file.

Create your file

  1. 1. Project
  2. 2. Working rules
  3. 3. Review & download
1. Tell Claude about your project

All fields are optional. Unknown details become inspection tasks, not guesses.

Unsaved entries stay in this page’s memory. Use Save to my workspace to upload a text copy, or download before refreshing or closing the tab. Builder choices are not included in saved text copies. Downloaded files stay on your device.

Where to put the file

  1. Download and review the generated file. If a CLAUDE.md already exists, compare and merge useful rules instead of replacing it blindly.
  2. Save it in the project’s top-level folder, beside files such as README.md. Check that the name is exactly CLAUDE.md, not CLAUDE.md.txt.
  3. Using the browser? Add the file to the GitHub repository and branch attached to your Claude Code task, using your normal review process.
  4. Check that Claude loaded it. In a supported terminal session, use /context and inspect the memory files. Ask Claude to summarize the project instructions and compare its answer with your file.

Keep these rules short and specific. Your next task still belongs in the conversation. For stronger application protections, follow the beginner security lessons.

References

Reviewed September 24, 2026. These links explain the underlying controls; a copied prompt is not a security certification.

Was this chapter useful?

Report an error

Votes are shared only if you enable optional measurement in Privacy settings.

CONTINUE THE GUIDECommands & shortcuts

Edit this example

Changes here affect this copy only. Nothing runs from this site. Closing this window discards your edits.

Search the field guide

Search all chapters and FAQ answers. Use Tab to reach a result and Enter to open it.