Claude Code setup that just works. Bootstrap every project with agents, hooks, commands, and smart permissions. One command, zero headaches.
npm create claudeAdds local Claude Code config files to your project. ZERO dependencies, ZERO overhead.
npm create claude # npm
pnpm create claude # pnpm
bun create claude # bun
yarn create claude # yarnnpm create claude --dry-run # Preview files
npm create claude --help # All optionscld # Short alias
npx cld # Via npxnpm i create-claudeimport { init } from 'create-claude';
await init('./my-project');- bypassPermissions mode: Claude Code operates freely while dangerous operations are blocked
- Smart safety hooks: Only blocks truly destructive commands (rm -rf /, sudo rm, disk formatting)
- Delete confirmations: All file/directory deletions require explicit user approval
/commit: Create git commits with Haiku model for cost efficiency/explain: Get concise code explanations/fix: Fix issues with structured approach/optimize: Performance improvements/pr: Create pull requests with git context/review: Brutal code reviews/test: Run tests with pattern support/validate: Lint, typecheck, and format
- pre-commit: Ruthless validation before commits
- refactor: Aggressive complexity reduction
- debugger: Root cause analysis and fixes
- Session hooks: Automatic cleanup on exit
- Advanced statusline: Git status, framework detection, color-coded information with modular helpers
- Import-based memory: CLAUDE.md uses
@imports for README and dynamically includes project configs (package.json, Cargo.toml, etc.) - Terse output style: Minimal, efficient responses without bloat
Is it safe to run?
Yes. It only creates config files, never modifies your code. Each file operation uses SHA256 checksums and creates timestamped backups.
# If something goes wrong, backups are here:
ls .create-claude-backup-*How do I remove it?
Delete the config files:
rm -rf .claude CLAUDE.mdYour original code stays untouched.
What are the requirements?
- Node.js 18+
- Claude Code (the CLI tool)
That's it. No global installs, no dependencies.
Does it work with my tools?
It auto-detects:
- Formatters: Prettier, ESLint, Biome, dprint
- Package managers: npm, yarn, pnpm, bun
- Languages: JavaScript, TypeScript, Python, Go, Rust
- Frameworks: React, Vue, Next.js, etc.
Can't find your tool? It falls back to sensible defaults.
What files does it create?
Creates 20 files in total:
.claude/
├── settings.local.json # Permissions, tool detection
├── hooks/
│ ├── format.cjs # Auto-format on save
│ ├── safety.cjs # Block dangerous operations
│ └── session-end.cjs # Cleanup on exit
├── agents/
│ ├── pre-commit.md # Ruthless validation
│ ├── refactor.md # Complexity reduction
│ └── debugger.md # Root cause analysis
├── commands/
│ ├── commit.md # Git commits with Haiku
│ ├── explain.md # Code explanations
│ ├── fix.md # Structured fixes
│ ├── optimize.md # Performance improvements
│ ├── pr.md # Pull request creation
│ ├── review.md # Brutal code reviews
│ ├── test.md # Test runner
│ └── validate.md # Lint, typecheck, format
├── scripts/
│ ├── statusline.cjs # Git status in prompt
│ ├── statusline-git.cjs # Git operations helper
│ └── statusline-detect.cjs # Framework detection helper
└── output-styles/
└── terse.md # Minimal output style
CLAUDE.md # Project-specific instructions
This project follows security best practices:
- All dependencies are audited and kept up-to-date
- Code is scanned with CodeQL and other security tools
- OpenSSF Scorecard certified
- Signed releases with build provenance
Report security issues: SECURITY.md
Contributions welcome! Please read SECURITY.md first, then:
- Fork the repo
- Create a feature branch
- Run
npm run validatebefore committing - Submit a pull request
Issues • Changelog • Claude Code Docs • Security
MIT © RMNCLDYO