Skip to content

cbolard/my-claude-config

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

my-claude-config

Personal Claude Code configuration — skills, MCP servers, and global conventions. Run this on any machine (local or VPS) to get a fully configured environment.


Installation

Ask Claude Code to set up this config:

Read the README.md and follow the installation steps.

Or do it manually section by section below.


0. Bootstrap (nouvelle machine)

git clone git@github.com:cbolard/my-claude-config.git ~/my-claude-config
cd ~/my-claude-config
git submodule update --init
mkdir -p ~/.claude/skills
ln -sf ~/my-claude-config/skills/gstack ~/.claude/skills/gstack

Puis continuer avec les sections 1, 2, 3, 4 ci-dessous.


1. Plugins

# Core
claude plugin install context7@claude-plugins-official
claude plugin install claude-md-management@claude-plugins-official
claude plugin install commit-commands@claude-plugins-official
claude plugin install security-guidance@claude-plugins-official
claude plugin install hookify@claude-plugins-official
claude plugin install frontend-design@claude-plugins-official
claude plugin install claude-code-setup@claude-plugins-official

# Language servers
claude plugin install typescript-lsp@claude-plugins-official
claude plugin install pyright-lsp@claude-plugins-official

# Workflow
claude plugin install playwright@claude-plugins-official
claude plugin install superpowers@claude-plugins-official

# Integrations
claude plugin install figma@claude-plugins-official
claude plugin install vercel@claude-plugins-official
claude plugin install railway@claude-plugins-official
claude plugin install stripe@claude-plugins-official

# Cloudflare (R2, Workers, DNS, etc.)
claude plugin marketplace add cloudflare/skills

# HUD (statusline — context %, git, tools, agents, todos)
claude plugin marketplace add jarrodwatts/claude-hud
claude plugin install claude-hud

HUD — configuration

Après l'install, créer ~/.claude/plugins/claude-hud/config.json :

{
  "lineLayout": "expanded",
  "pathLevels": 2,
  "gitStatus": {
    "enabled": true,
    "showDirty": true,
    "showAheadBehind": true,
    "showFileStats": false
  },
  "display": {
    "showTools": true,
    "showAgents": true,
    "showTodos": true,
    "showDuration": false,
    "showConfigCounts": false,
    "showUsage": true,
    "usageBarEnabled": true,
    "showContextBar": true,
    "contextValue": "percent",
    "showModel": true,
    "showSessionName": false
  }
}

Puis lancer /claude-hud:setup pour configurer le statusline dans ~/.claude/settings.json.


2. MCP Servers (global)

Ces serveurs sont disponibles dans tous les projets.

⚠️ Important : Les MCP servers globaux s'ajoutent via claude mcp add --scope user — ils sont stockés dans ~/.claude.json. N'utilise pas permissions.mcpServers dans settings.json : ce champ est ignoré par Claude Code.

# GitHub (PAT — le plugin OAuth github@claude-plugins-official est incompatible)
claude mcp add --scope user github \
  -- npx -y @modelcontextprotocol/server-github
# ⚠️ Puis éditer ~/.claude.json pour ajouter "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "GITHUB_PAT" }

# Remotion (documentation Remotion pour génération de vidéos)
claude mcp add --scope user remotion-documentation -- npx @remotion/mcp@latest

# Chrome DevTools (inspection, screenshots, network, automation)
claude mcp add --scope user chrome-devtools \
  -- npx -y chrome-devtools-mcp@latest --no-usage-statistics

# PostHog
claude mcp add --scope user --transport stdio posthog \
  -- npx -y mcp-remote https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer POSTHOG_API_KEY"

# Prisma (local — lit le schema.prisma du projet courant)
claude mcp add --scope user prisma-local -- npx -y prisma mcp

# Prisma (remote — gestion des bases Prisma Postgres)
claude mcp add --scope user --transport http prisma-remote https://mcp.prisma.io/mcp

# shadcn/ui (local — doit pointer vers le projet front qui contient components.json)
claude mcp add --scope user shadcn -- npx shadcn@latest mcp
# ⚠️ Puis éditer ~/.claude.json pour ajouter "cwd": "/chemin/vers/ton/projet/front"

Remplace POSTHOG_API_KEY par ta clé API PostHog. Remplace GITHUB_PAT par ton Personal Access Token GitHub dans ~/.claude.json. Le MCP shadcn doit impérativement avoir un cwd pointant vers le projet front — sinon 404. Les autres plugins (Figma, Vercel, Railway, Stripe, Cloudflare) s'authentifient via OAuth au premier lancement — aucun token à gérer.


3. MCP Servers (par projet)

Railway (n8n_saas backend)

Railway MCP est scopé au projet n8n_saas uniquement (pas le front).

cd ~/outapply/n8n_saas
claude mcp add Railway -- npx -y @railway/mcp-server

Auth OAuth au premier lancement — aucun token à gérer. Un .mcp.json de backup existe aussi dans n8n_saas/.

n8n

n8n est configuré via claude mcp add --scope user (stocké dans ~/.claude.json) comme les autres MCP globaux.

⚠️ Ne pas utiliser ~/.config/Claude/claude_desktop_config.json — ce fichier est lu uniquement par Claude Desktop, pas par Claude Code.

claude mcp add --scope user n8n-mcp \
  -- npx -y supergateway \
  --streamableHttp N8N_INSTANCE_URL/mcp-server/http \
  --header "authorization:Bearer N8N_API_TOKEN"

Instances connues :

Projet URL
n8n_saas https://n8n-production-75d6.up.railway.app

Remplace N8N_INSTANCE_URL et N8N_API_TOKEN par les valeurs du projet. Le token JWT est stocké directement dans ~/.claude.json — ne jamais le committer.


4. Skills

Stratégie workflow

Besoin Skill à utiliser Pourquoi
Brainstorm / design Superpowers brainstorming Affinement Socratique, sauvegarde un doc design
Plan d'implémentation Superpowers writing-plans Tâches 2-5 min, chemins exacts, code complet
Exécution des tâches Superpowers subagent-driven-development Subagents parallèles, double review par tâche
Debug / erreurs Superpowers systematic-debugging 4 phases : investigate → analyze → hypothesize → implement
TDD Superpowers test-driven-development RED-GREEN-REFACTOR enforced
Code review pre-merge Superpowers requesting-code-review Checklist pré-review structurée
Merge / PR / deploy Superpowers finishing-a-development-branch Vérifie tests, gère merge/PR/discard
Review stratégique (founder) gstack /plan-ceo-review YC-style — pas d'équivalent dans Superpowers
Review architecture gstack /plan-eng-review EM-mode — complément de Superpowers
QA browser / dogfood gstack /browse + /qa Superpowers n'a pas de browser automation
Déploiement / push gstack /ship Sync main, tests, push, PR

Global

mkdir -p skills
git clone git@github.com:garrytan/gstack.git skills/gstack
ln -sf ~/my-claude-config/skills/gstack ~/.claude/skills/gstack

# Remotion (skill officiel remotion-dev — best practices + 38 règles spécialisées)
git clone --depth 1 https://github.com/remotion-dev/skills.git /tmp/remotion-skills-tmp
cp -r /tmp/remotion-skills-tmp/skills/remotion ~/.claude/skills/remotion
rm -rf /tmp/remotion-skills-tmp

Par projet (à installer à la racine du projet concerné)

Tout projet front Next.js / React (shadcn/ui) :

npx shadcn skills add

n8n_saas uniquement (Resend + email) :

npx skills add resend/resend-skills
npx skills add resend/react-email
npx skills add resend/email-best-practices

5. Synchronisation entre machines

# Machine locale → push
cd ~/my-claude-config
git add . && git commit -m "update config"
git push

# VPS ou autre machine → pull
cd ~/my-claude-config && git pull
# Si gstack pas encore cloné sur cette machine
git clone git@github.com:garrytan/gstack.git skills/gstack
ln -sf ~/my-claude-config/skills/gstack ~/.claude/skills/gstack

Les plugins et MCP sont à réinstaller une fois sur chaque nouvelle machine (étapes 1 et 2). Les tokens ne transitent jamais par Git.


Structure du repo

my-claude-config/
├── README.md          ← ce fichier
├── CLAUDE.md          ← conventions globales (lu automatiquement par Claude Code)
└── skills/
    └── gstack/        ← symlinké vers ~/.claude/skills/gstack

Récapitulatif des niveaux

Quoi Niveau Raison
HUD (claude-hud) Global machine Statusline avec context, git, tools, agents
Plugins (tous) Global machine Même tooling partout
PostHog MCP Global machine Une seule instance
Prisma MCP Global machine Lu depuis le projet courant
shadcn MCP Global machine Nécessite cwd → projet front
Cloudflare Global machine R2 partagé entre projets
n8n MCP Global machine (~/.claude.json) Via claude mcp add --scope user — token JWT jamais commité
Railway MCP Par projet (n8n_saas) OAuth auto — claude mcp add Railway -- npx -y @railway/mcp-server
shadcn skill Par projet front Lit components.json local
Resend skills Par projet (n8n_saas) Templates spécifiques
Chrome DevTools MCP Global machine Screenshots, network, automation Chrome
GitHub MCP Global machine PAT dans ~/.claude.json (plugin OAuth désactivé)
gstack skills Global machine Browser automation (/browse, /qa), revues stratégiques (/plan-ceo-review, /plan-eng-review), deploy (/ship)
Superpowers Global machine Workflow dev : brainstorm → plan → subagent execution → debug → TDD → review → merge
remotion skill Global machine Génération de vidéos (landing, social, etc.)

About

Claude code global setup

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors