Auf /downloads finden Sie alle aktuellen Distributionen
Ihrer 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: Sie bekommen immer eine einheitliche Versionsnummer auf allen Plattformen pro Release.
Über die UI vs. über die API
Im Portal klicken Sie auf das Artefakt und es wird heruntergeladen.
Das Session-Cookie übernimmt die Auth. Bei den CLI-Archiven und dem
Installer haben Sie die Wahl zwischen zwei Varianten: mit Lizenz (Ihre
codecharter.license liegt mit im Archiv) und ohne Lizenz (das
unveränderte Archiv). Die VSIX gibt es immer ohne eingebettete Lizenz.
Zusätzlich können Sie Ihre 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 Sie eine frisch ausgestellte Lizenz brauchen,
etwa direkt nach einer Verlängerung der Subscription, nutzen Sie 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
Sie die Prüfsumme der erhaltenen Datei verifizieren können.
Mehr Details unter API-Keys verwalten.
Latest vs. konkrete Version
In der URL können Sie 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: Ihre Subscription ist abgelaufen (API-Downloads). Verlängern Sie sie im Portal.
- 403 Forbidden: kommt bei Portal-Downloads (Cookie-Auth), wenn Ihre Subscription nicht aktiv ist.
- 404 Not Found: kein Release passt zur angefragten Version. Vergleichen Sie mit dem Release-Channel-Log.
- Timeouts: sollten bei den aktuellen Dateigrößen nicht auftreten. Falls doch, schreiben Sie uns kurz, wir prüfen das auf unserer Seite.