Die vollständige Referenz
Diese Seite bringt dich zur Installation und zum ersten Fix. Die vollständige Dokumentation behandelt CLI, Review, den MCP-Server, die GitHub App, die GitHub Action, Konfiguration und Kernkonzepte auf docs.codna.ai.
Docs
Codna mit einem Befehl installieren.
Python 3.10 oder neuer, macOS oder Linux und git. Kein Node, Docker oder Server zu installieren.
Installieren
Installiere die CLI von PyPI mit pip, pipx oder uv. Alles läuft auf deinem Rechner. Melde dich für das verwaltete Guthaben an, oder speichere deinen eigenen Anbieterschlüssel im Schlüsselbund des Betriebssystems.
pip install codna codna --version codna key set anthropic
Schnellstart
Zuerst ein Repo für null Tokens verstehen. Dann Codna bitten, ein bestimmtes Issue zu beheben.
codna triage . codna fix . --issue "the checkout test is failing"
CLI
Triage, fix, review und secure. Jeder Befehl akzeptiert --json, und Fehler kommen als JSON auf stderr.
codna triage . --json codna fix . --tests --apply --max-iterations 3 codna fix https://github.com/org/repo --issue "..." --open-pr codna review . --pr 42 --post codna secure . --from-sarif results.sarif
MCP-Server
Installiere das mcp-Extra und füge Codna dann mit einem Befehl zu Cursor oder Claude hinzu. Fünf Werkzeuge: codna_triage, codna_fix, codna_secure, codna_recall und codna_report_bug.
pip install "codna[mcp]" codna mcp install --client cursor codna mcp install --client claude
GitHub App
Installiere die App auf deinem Konto oder deiner Organisation und wähle die Repositories. Codna prüft jeden Pull Request. Verknüpfe die Installation mit einem Codna-Konto für verwaltete Fixes, oder füge deinen eigenen Schlüssel hinzu.
# On a pull request @codna review # Reply on a Codna finding (write access) @codna fix # On an issue label: codna-fix · codna-secure
Konfiguration
codna.yaml enthält den Modellanbieter, Datenschutzeinstellungen und deinen Testbefehl. Secret-Redaktion ist immer aktiv.
model: provider: anthropic key: env:ANTHROPIC_API_KEY privacy: egress: fail-closed redact_secrets: true fix: test_command: pytest -q
FAQ
Was verlässt meinen Rechner? Nur das Evidenzbündel oder der Diff, gesendet an deinen Modellanbieter mit deinem Schlüssel. Triage und Recall laufen offline.
Wo melde ich einen Bug? Führe codna report aus. Es legt den Bericht im öffentlichen Feedback-Repository ab und fällt auf einen vorausgefüllten Issue-Link zurück, wenn du kein Token hast.
Häufige Fragen
pip install codna, pipx install codna oder uv tool install codna. Du brauchst Python 3.10 oder neuer, macOS oder Linux und git im PATH. Die CLI läuft lokal mit deinem eigenen Modellschlüssel.
Cursor und Claude. Installiere das mcp-Extra und führe dann codna mcp install --client cursor oder --client claude aus. Der Server schreibt niemals Zugangsdaten in deine Editor-Konfiguration.
Die App führt dieselben codna-Befehle aus, gehostet von Codna. Sie prüft jeden Pull Request, antwortet auf @codna review, öffnet einen Fix, wenn ein Mitwirkender mit Schreibzugriff @codna fix auf einen Fund antwortet, und reagiert auf die Labels codna-fix und codna-secure sowie auf rote Check-Suites.
Die CLI läuft auf deinem Rechner. Dein Anbieterschlüssel liegt im Schlüsselbund des Betriebssystems und wird nie ausgegeben. Nur das Evidenzbündel oder der Diff erreicht deinen Modellanbieter. Setze privacy.egress in codna.yaml auf fail-closed, und Codna führt deine Tests nur unter Netzwerksperre auf Kernel-Ebene aus und macht während des Reviews keine Registry-Abfragen.
In 87 abgestimmten Fällen gegen Cursor brauchte Codna im Schnitt 16.159 Tokens und etwa 0,02 $ an Modellausgaben pro verifiziertem Fix, 5× weniger Tokens und 1,7× schneller.
Die Repository-Karte wird aus Import-Mustern gebaut und ist daher nicht an eine Sprache gebunden. On-Device-Recall deckt Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP und Ruby ab. Setze fix.test_command auf deinen eigenen Test-Runner.