techtown-claude-code

Configuration Claude Code niveau organisation pour TechTown. La gouvernance se fait via les managed settings poussés depuis la console admin Anthropic (TechTown n'a pas de MDM).

Contenu

Fichier	Rôle
managed-settings.template.json	Source de vérité versionnée du JSON poussé dans la console admin Anthropic (settings managés, inviolables)
CLAUDE.md	Instructions Claude communes aux projets TechTown (à référencer/copier par projet)

Comment c'est déployé

Les managed settings ne se déploient pas par git — ils vivent côté serveur Anthropic :

1. Édite managed-settings.template.json dans ce repo (diff/historique git que la console n'offre pas).
2. Copie son contenu dans console admin → Claude Code → Paramètres gérés (claude.ai/admin-settings/claude-code).
3. Clique « Mettre à jour les paramètres ».
4. Chaque poste les récupère dans ~/.claude/remote-settings.json (au démarrage + refetch ~horaire).

⚠️ Les managed settings sont fetchés selon l'org authentifiée. Pour les voir s'appliquer, Claude Code doit être connecté sous l'org TechTown (/login → choisir TechTown). Une session connectée à une autre org (client, perso) ne verra jamais ces settings.

⚠️ La console valide contre le schéma Claude Code. Des paramètres invalides peuvent désactiver Claude Code pour toute l'org — toujours valider (jq . managed-settings.template.json) avant de coller.

Ce que contient la config managée

• Sécurité : deny des secrets (.env, ~/.ssh, ~/.config/gcloud, ~/.aws, ~/.gnupg) + curl|sh ; ask sur les effets destructifs (force push, reset --hard, gcloud/gsutil/terraform delete, rm -rf, formatage disque…).
• Serveurs MCP fournis : managedMcpServers déclare Meetown (https://mcp.meetown.techtown.fr/mcp). ⚠️ Sans effet aujourd'hui, voir Limite connue : managedMcpServers.
• Marketplace TechTown : extraKnownMarketplaces enregistre techtown-marketplace sur chaque poste (plus besoin de claude plugin marketplace add), avec autoUpdate: true pour que les nouvelles versions des plugins arrivent sans action. Enregistrer la marketplace n'installe aucun plugin : c'est enabledPlugins qui en impose.
• Gouvernance : forceLoginOrgUUID (verrou org TechTown), allowedMcpServers (allowlist MCP souple : github, context7, playwright — sans allowManagedMcpServersOnly, chaque collaborateur peut l'élargir dans ses propres settings), strictKnownMarketplaces (2 marketplaces officielles Anthropic + techtown-marketplace), disableBypassPermissionsMode.
• Conventions org : model (claude-sonnet-4-6), language (français), companyAnnouncements, attribution, includeGitInstructions, requiredMinimumVersion.

Choix de design : les allow ne sont pas verrouillés au niveau managé — chaque collaborateur garde ses allow projet/user. Le managé n'impose que les garde-fous ask/deny et la gouvernance. L'auto-mode n'est pas bloqué.

Limite connue : managedMcpServers

La même clé désigne deux formats différents :

Lecteur	Format attendu	Doc
Claude Code	objet indexé par nom : { "meetown": { "type": "http", "url": "…" } }	managed-mcp
Claude Desktop (déploiements tiers uniquement)	tableau d'entrées	desktop

Le schéma schemastore, contre lequel la console valide, ne connaît que le format tableau de Desktop. La console refuse donc le format objet de Claude Code, et Claude Code ignore le tableau. Constaté le 2026-09-28 : le ~/.claude/remote-settings.json récupéré juste après la mise à jour contient toutes les autres clés, mais pas managedMcpServers, et claude mcp list ne montre pas Meetown.

Le tableau reste dans le template parce que c'est ce qui est déployé dans la console. Tant que le schéma n'est pas corrigé, la distribution de Meetown passe par le connecteur d'organisation sur claude.ai (voir la PR qui introduit cette section).

Niveaux de settings dans Claude Code

Priorité (du plus fort au plus faible)
┌────────────────────────────────────────────────────────┐
│ Managed  (console admin / server-managed)   ← INVIOLABLE │  ← ce repo
│ CLI args                                                 │
│ Local    .claude/settings.local.json (gitignore)         │
│ Projet   .claude/settings.json (commité)                 │
│ User     ~/.claude/settings.json                         │
└────────────────────────────────────────────────────────┘

Cache local des managed settings fetchés : ~/.claude/remote-settings.json (lecture seule)

Instructions org (CLAUDE.md)

CLAUDE.md n'est pas distribuable via managed settings. Pour l'appliquer à un projet, copie-le ou référence-le :

curl -s https://raw.githubusercontent.com/techtown-fr/techtown-claude-code/main/CLAUDE.md > CLAUDE.md

Contribuer

PRs bienvenues. Soumettre à benjamin.bourgeois@techtown.fr ou nikolas.bouron@techtown.fr pour review.