Auf /downloads findest du alle aktuellen Distributionen
deiner Subscription. Die Seite zeigt das neueste Stable-Release sowie eine
Liste älterer Releases; jedes ältere Release hat eine eigene Seite unter
/downloads/v{version}.
Was zur Auswahl steht
| Artefakt | Wofür |
|---|---|
| Windows-Installer (.exe) | Devs unter Windows, alles in einem Setup |
| CLI Windows x64 (ZIP) | CI-Runner unter Windows |
| CLI Linux x64 (tar.gz) | CI-Runner unter Linux, Docker |
| CLI macOS x64 (tar.gz) | Devs auf älteren Macs (Intel) |
| CLI macOS arm64 (tar.gz) | Devs auf Apple Silicon |
| VS Code Extension (VSIX) | Editor-Integration |
Alle Artefakte werden zusammen veröffentlicht: Du bekommst immer eine einheitliche Versionsnummer auf allen Plattformen pro Release.
Über die UI vs. über die API
Im Portal wählst du das Artefakt und es wird heruntergeladen.
Das Session-Cookie übernimmt die Auth. Bei den CLI-Archiven und dem
Installer hast du die Wahl zwischen zwei Varianten: mit Lizenz (deine
codecharter.license liegt mit im Archiv) und ohne Lizenz (das
unveränderte Archiv). Die VSIX gibt es immer ohne eingebettete Lizenz.
Zusätzlich kannst du deine Lizenz über den Button oben auf der Seite
einzeln als codecharter.license herunterladen; dafür ist eine aktive
Subscription nötig.
Hinweis zur Variante mit Lizenz: Das lizenzierte Archiv wird einmal pro
Nutzer und Artefakt gebaut und danach bis zu 30 Tage aus einem
nutzerbezogenen Cache ausgeliefert. Die eingebettete Lizenz kann also bis
zu 30 Tage alt sein. Wenn du eine frisch ausgestellte Lizenz brauchst,
etwa direkt nach einer Verlängerung der Subscription, nutze den
separaten codecharter.license-Download; dieser stellt immer eine neue
Lizenz aus.
Über die API für automatisierte Pulls (CI):
curl -L -H "Authorization: Bearer $CODECHARTER_API_KEY" \
-o codecharter-cli.tar.gz \
https://codecharter.tools/api/v1/cli/linux-x64/latest
API-Downloads liefern immer das unveränderte Archiv ohne eingebettete
Lizenz. CI holt sich separat eine kurzlebige Lizenz über
GET /api/v1/cli/license, authentifiziert mit demselben API-Key.
Jede Download-Antwort enthält einen X-CodeCharter-Sha256-Header, mit dem
du die Prüfsumme der erhaltenen Datei verifizieren kannst.
Mehr Details unter API-Keys verwalten.
Latest vs. konkrete Version
In der URL kannst du latest, eine vollständige Versionsnummer oder ein
Versionspräfix einsetzen: 1, 1.4 und 1.4.2 funktionieren, mit oder
ohne führendes v. Es gewinnt das neueste Release, das zum Präfix passt:
https://codecharter.tools/api/v1/cli/linux-x64/latest
https://codecharter.tools/api/v1/cli/linux-x64/1.0.12
Empfehlung für CI: immer pinnen. latest ist okay für lokale Tests
oder Devs, die immer aktuell sein wollen.
Siehe Versionierung.
Channels
Alle Downloads kommen aus dem Stable-Channel; jedes dort veröffentlichte Release ist geprüft.
Mehr unter Channels.
Wenn ein Download fehlschlägt
- 400 Bad Request: unbekannter Plattform-Slug. Gültig sind
win-x64,linux-x64,osx-x64undosx-arm64. - 401 Unauthorized: API-Key fehlt oder ist falsch.
- 402 Payment Required: deine Subscription ist abgelaufen (API-Downloads). Verlängere sie im Portal.
- 403 Forbidden: kommt bei Portal-Downloads (Cookie-Auth), wenn deine Subscription nicht aktiv ist.
- 404 Not Found: kein Release passt zur angefragten Version. Vergleiche mit dem Release-Channel-Log.
- Timeouts: sollten bei den aktuellen Dateigrößen nicht auftreten. Falls doch, schreib uns kurz, wir prüfen das auf unserer Seite.