ConfigDeckGetting started with Claude Code configuration
Where agents, skills, commands, CLAUDE.md and MCP live — fast.
Check it's installed first
Verified on this Mac (2026-07-29):
$ claude --version
2.1.199 (Claude Code)What .claude/ actually looks like
A project with a couple of skills installed looks like this:
.claude/
├─ agents/
│ └─ reviewer.md
├─ skills/
│ └─ keihi-seisan/
│ └─ SKILL.md
├─ commands/
├─ settings.json
└─ (project root) CLAUDE.mdThe first-run "trust this workspace" prompt
New project folders ask you to trust the workspace once — needed for `permissions.allow` auto-approval rules to take effect.
What to install first
Start with one reviewer subagent, confirm it behaves, then add CLAUDE.md rules, then skills/hooks/MCP incrementally — avoids the "why isn't this working" confusion of installing everything at once.
FAQ
How do I check Claude Code is installed?
Run `claude --version`. On this Mac it showed `2.1.199 (Claude Code)` on 2026-07-29.
Why am I asked to trust the workspace on first run?
It's needed once, to enable permissions.allow auto-approval rules.
What should I install first?
One reviewer subagent first, then CLAUDE.md, then skills/hooks/MCP incrementally.
What does .claude/ actually contain?
agents/, skills/, commands/, settings.json, plus CLAUDE.md at the project root.