_____ _ _ _____ _
/ ____| | | | / ____| | |
| | | | __ _ _ _ __| | ___ | (___ ___| |_ _ _ _ __
| | | |/ _` | | | |/ _` |/ _ \ \___ \ / _ \ __| | | | '_ \
| |____| | (_| | |_| | (_| | __/ ____) | __/ |_| |_| | |_) |
\_____|_|\__,_|\__,_|\__,_|\___||_____/ \___|\__|\__,_| .__/
| |
|_|
Le setup parfait pour Claude Code en 5 minutes.
claude-setup est un skill conversationnel qui automatise tout ce qu'un nouveau dev doit faire après avoir installé Claude Code : Second Brain, CLIs, MCP servers, skills, sub-agents et API keys. Une seule commande, et tu pars de zéro à un environnement productif.
bash <(curl -fsSL https://raw.githubusercontent.com/gquthier/claude-setup/main/install.sh)Le script va :
- Détecter ton OS, shell et runtimes installés.
- Initialiser ton Second Brain à
~/brainOS/. - Installer les CLIs manquants (Claude Code, gh, vercel, playwright).
- Cloner
anthropics/skillsetmsitarzewski/agency-agents. - Câbler le Playwright MCP server dans
~/.claude.json. - Centraliser tes API keys dans
~/brainOS/secrets/keystore.env(chmod 600). - Créer un agent perso avec son
soul.md.
Le tout en posant ~12 questions et en respectant ce qui est déjà installé.
| Composant | Source | Destination |
|---|---|---|
| Second Brain (Obsidian-compatible) | Templates locaux | ~/brainOS/ |
| Skills officiels Anthropic | anthropics/skills |
~/brainOS/skills/anthropic/ |
| 32 sub-agents Agency | msitarzewski/agency-agents |
~/.claude/agents/ |
| Playwright MCP server | @playwright/mcp (npx) |
~/.claude.json |
| Claude Code CLI | @anthropic-ai/claude-code |
/usr/local/bin/claude |
| GitHub CLI | Homebrew / apt | /usr/local/bin/gh |
| Vercel CLI | npm | ~/.npm-global/bin/vercel |
| API keys keystore | env vars + prompts | ~/brainOS/secrets/keystore.env (chmod 600) |
| Agent perso | Template soul.md |
~/brainOS/agents/<id>/soul.md |
┌─────────────────────────────────────────────────────────────┐
│ Claude Code Session │
│ │
│ ┌────────────┐ ┌────────────┐ ┌──────────────────┐ │
│ │ Skills │ │ Sub-agents │ │ MCP Servers │ │
│ │ ~/.claude │ │ ~/.claude/ │ │ ~/.claude.json │ │
│ │ /skills │ │ agents │ │ (playwright,…) │ │
│ └────────────┘ └────────────┘ └──────────────────┘ │
│ │ │ │ │
│ └────────────────┴────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────┐ │
│ │ Second Brain │ │
│ │ ~/brainOS/ │ │
│ │ user.md environment.md │ │
│ │ goals.md agents/<id>/ │ │
│ │ skills/ secrets/ │ │
│ └────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Voir docs/ARCHITECTURE.md pour le détail.
Le skill pose ~12 questions pour personnaliser ton setup :
- Identité — prénom, rôle, stack principal.
- Niveau Claude Code — pour adapter le ton et la verbosité de l'agent perso.
- Agent perso — nom et ton (formel / direct / cool), génère un
soul.md. - Intégrations — Vercel, GitHub, Anthropic API.
- Path Second Brain —
~/brainOSpar défaut, customisable.
Toutes les réponses sont stockées dans ~/brainOS/user.md et peuvent être éditées plus tard.
Voir docs/TROUBLESHOOTING.md pour les problèmes courants :
ghnon authentifié → relancegh auth login.- Playwright MCP ne se charge pas → vérifie que
npxest dans le PATH. - Permission denied sur
keystore.env→chmod 600 ~/brainOS/secrets/keystore.env. - Le keystore ne se lit pas dans Claude Code → ajoute
source ~/brainOS/secrets/keystore.envdans ton shell rc.
Relance install.sh autant de fois que tu veux. Le script :
- Skip les CLIs déjà installés.
- Préserve les fichiers existants (sauf demande explicite).
- Merge la config MCP via
jq— n'écrase rien. - Conserve les API keys déjà présentes.
- Présentation YouTube de @gquthier — Le setup parfait pour Claude Code.
anthropics/skills— skills officiels.msitarzewski/agency-agents— collection communautaire de sub-agents.
MIT — voir LICENSE.
Built by Gauthier.