Skip to content

Windows-Installer

Der empfohlene Weg auf Entwickler-Maschinen unter Windows.

Aktualisiert am 2026-06-03

Der Windows-Installer ist der bequemste Weg auf einer Windows-Workstation. Er bringt die CLI mit, kann sie im PATH registrieren, installiert die VS-Code- Extension wenn VS Code gefunden wird, und lässt euch auswählen, welche Default-Regeln und welche Lizenz installiert werden.

Download

Holt den Installer aus dem Portal unter /downloads. Ihr braucht dafür eine aktive Subscription oder einen laufenden Trial.

Die Datei heißt codecharter-X.Y.Z-setup.exe. Etwa 8 MB groß, weil die .NET-Runtime nicht mitgebracht werden muss. Der Installer ist framework-dependent und nutzt das auf der Maschine installierte .NET. Fehlt es, bietet der Installer an, die .NET-9-Runtime per winget für euch zu installieren.

Die Download-Seite bietet zwei Varianten:

  • Mit Lizenz — ihr erhaltet codecharter-X.Y.Z-setup-licensed.zip. Entpackt, liegt die Setup-EXE neben einer codecharter.license. Der Installer erkennt diese Lizenz automatisch und wählt sie auf der Lizenzseite vor (siehe unten).
  • Ohne Lizenz — nur die nackte codecharter-X.Y.Z-setup.exe. Ihr könnt den Installer trotzdem manuell auf eine Lizenzdatei verweisen oder sie später hinzufügen.

Installation

Führt die EXE aus und klickt euch durch den Wizard. Die Seiten sind:

  1. Zielverzeichnis — der Installer zeigt immer an, wohin installiert wird. Default ist der Programmordner (C:\Program Files\CodeCharter\ bei einer All-Users-Installation, oder ein benutzerspezifischer Ordner ohne Admin-Rechte). Hier könnt ihr ein anderes Verzeichnis wählen.

  2. Komponenten auswählen — wählt, was installiert wird:

    • CodeCharter CLI (immer installiert).
    • Default-Regelsatz, mit einer Checkliste einzeln wählbarer Kategorien: allgemeine C#-Regeln, ASP.NET-Core-Regeln, Contract-/Pattern-Regeln und Regeln zu unerwünschten Suffixen. Haakt die ganze Gruppe ab, um gar keine Default-Regeln zu installieren. Die CLI findet sie automatisch unter <Installordner>\rules.

    Der Setup-Typ Compact wählt nur die CLI vor, Full alles.

  3. Zusätzliche Aufgaben — codecharter zum PATH hinzufügen, die VS-Code- Extension installieren (falls VS Code erkannt wird) und codecharter.serverPath in euren VS-Code-Benutzereinstellungen setzen.

  4. Lizenz — optional jetzt eine Lizenz installieren. Liegt eine codecharter.license neben der Setup-EXE (der Mit Lizenz-Download), ist sie automatisch vorausgewählt; ansonsten könnt ihr über Durchsuchen… eine auswählen. Die gewählte Datei wird als codecharter.license in den Installordner kopiert, wo die CLI sie automatisch findet. Ihr könnt das überspringen und eine Lizenz später ergänzen, etwa über die Umgebungsvariable CODECHARTER_LICENSE — siehe Lizenzierung.

  5. AI-Tools (MCP) — registriert den CodeCharter-MCP-Server in euren AI-Coding-Tools. Der Installer erkennt vorhandene Tools (Claude Code, Claude Desktop, Cursor, Windsurf, Gemini) und wählt sie vor; haakt ab, was ihr nicht wollt. Der Server wird in die benutzerbezogene MCP-Config des jeweiligen Tools eingetragen. Diese Seite erscheint nur, wenn mindestens ein Tool erkannt wird und eine Lizenz verfügbar ist — codecharter mcp install braucht eine Lizenz, und der Eintrag ruft den codecharter-Befehl auf, weshalb die Aufgabe Zum PATH hinzufügen bei MCP-Konfiguration automatisch aktiviert wird.

  6. Bereit zur Installation — bestätigt Zielordner und Komponenten und installiert dann.

Stille Installation

Für eine stille Installation (z.B. via Group Policy oder MDM) nutzt die Standard-Schalter von Inno Setup:

codecharter-X.Y.Z-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

Nützliche Schalter:

  • /DIR="C:\Tools\CodeCharter" — Zielordner überschreiben.
  • /COMPONENTS="cli,rules\general,rules\aspnetcore" — exakt auswählen, welche Komponenten installiert werden (weglassen für den Default-Satz Full).
  • /TASKS="addtopath" — auswählen, welche Zusatzaufgaben laufen.
  • /LOG="install.log" — ein ausführliches Install-Log schreiben.

Im stillen Modus werden die Lizenz- und die MCP-Seite übersprungen. Eine codecharter.license neben der EXE wird trotzdem automatisch installiert, der MCP-Server jedoch nicht konfiguriert. Für unbeaufsichtigte Setups registriert ihn danach pro Tool, z.B.:

codecharter mcp install --client cursor --scope user

Unterstützte --client-Werte: claude-code, claude-desktop, cursor, windsurf, gemini.

Was der Installer macht

  1. CLI ablegen unter <Installordner>\codecharter.exe (default C:\Program Files\CodeCharter\codecharter.exe).
  2. Gewählte Default-Regeln installieren unter <Installordner>\rules, sofern welche ausgewählt wurden.
  3. PATH ergänzen (wenn die Aufgabe gewählt ist) — systemweit bei einer All-Users-Installation, sonst benutzerspezifisch. Eine neue PowerShell oder ein neues Terminal sieht das Binary danach direkt.
  4. VS-Code-Extension installieren, falls VS Code erkannt und die Aufgabe gewählt ist. Andernfalls überspringt der Installer diesen Schritt, ihr könnt die VSIX später manuell installieren.
  5. Lizenz installieren als <Installordner>\codecharter.license, falls ihr auf der Lizenzseite eine gewählt habt.
  6. MCP-Server registrieren in den gewählten AI-Tools, per codecharter mcp install --client <tool> --scope user je Tool. Die Config landet in der benutzerbezogenen Konfiguration des jeweiligen Tools in eurem Profil.

Update

Führt das neue Setup aus; es überschreibt die alte Version an Ort und Stelle. Ladet einfach die neue EXE und führt sie aus.

Deinstallation

Über "Apps & Features" oder den mitgelieferten Deinstaller (unins000.exe) im Installordner.

Der Deinstaller entfernt die installierten Dateien (inklusive der mitgelieferten Lizenz) und den von ihm gesetzten PATH-Eintrag. Eure .ccr-Dateien in euren Repos bleiben unangetastet.

Wenn ihr ohne Installer arbeiten wollt

Auf CI oder in Docker ist der Installer unhandlich. Nutzt dafür die Standalone-CLI, ein einzelnes ZIP mit einem Binary drin, kein Setup nötig.