Python 3.10 o superior, macOS o Linux, y git. Sin Node, Docker ni servidor que instalar.
Esta página te deja instalado y entregando una primera corrección. La documentación completa cubre la CLI, review, el servidor MCP, la GitHub App, la GitHub Action, la configuración y los conceptos clave en docs.codna.ai.
Abrir la documentación completa (se abre en una pestaña nueva)
Instala la CLI desde PyPI con pip, pipx o uv. Todo corre en tu máquina. Inicia sesión para el saldo gestionado, o guarda tu propia clave de proveedor en el llavero del sistema.
pip install codna codna --version codna key set anthropic
Primero, entiende un repo por cero tokens. Luego pide a Codna que corrija un issue concreto.
codna triage . codna fix . --issue "the checkout test is failing"
Triage, fix, review y secure. Cada comando acepta --json, y los errores llegan como JSON por 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
Instala el extra mcp y añade Codna a Cursor o Claude con un comando. Cinco herramientas: codna_triage, codna_fix, codna_secure, codna_recall y codna_report_bug.
pip install "codna[mcp]" codna mcp install --client cursor codna mcp install --client claude
Instala la App en tu cuenta u organización y elige los repositorios. Codna revisa cada pull request. Vincula la instalación a una cuenta de Codna para correcciones gestionadas, o añade tu propia clave.
# On a pull request @codna review # Reply on a Codna finding (write access) @codna fix # On an issue label: codna-fix · codna-secure
codna.yaml guarda el proveedor de modelo, los ajustes de privacidad y tu comando de tests. La redacción de secretos está siempre activa.
model: provider: anthropic key: env:ANTHROPIC_API_KEY privacy: egress: fail-closed redact_secrets: true fix: test_command: pytest -q
¿Qué sale de mi máquina? Solo el paquete de evidencia o el diff, enviado a tu proveedor de modelo con tu clave. Triage y recall funcionan sin conexión.
¿Dónde reporto un error? Ejecuta codna report. Lo registra en el repositorio público de feedback y, si no tienes token, recurre a un enlace de issue prellenado.
pip install codna, pipx install codna o uv tool install codna. Necesitas Python 3.10 o superior, macOS o Linux y git en el PATH. La CLI corre en local con tu propia clave de modelo.
Cursor y Claude. Instala el extra mcp y ejecuta codna mcp install --client cursor o --client claude. El servidor nunca escribe credenciales en la configuración de tu editor.
La App ejecuta los mismos comandos codna, alojada por Codna. Revisa cada pull request, responde a @codna review, abre una corrección cuando un colaborador con acceso de escritura responde @codna fix en un hallazgo, y actúa sobre las etiquetas codna-fix y codna-secure y sobre las check suites en rojo.
La CLI corre en tu máquina. Tu clave de proveedor vive en el llavero del sistema y nunca se imprime. Solo el paquete de evidencia o el diff llega a tu proveedor de modelo. Configura privacy.egress en fail-closed en codna.yaml y Codna ejecuta tus tests solo bajo denegación de red a nivel de kernel y no hace consultas al registro durante la revisión.
En 87 casos emparejados frente a Cursor, Codna promedió 16.159 tokens y unos 0,02 $ de gasto en modelo por corrección verificada, 5× menos tokens y 1,7× más rápido.
El mapa del repositorio se construye a partir de patrones de import, así que no está atado a un lenguaje. El recall en el dispositivo cubre Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP y Ruby. Configura fix.test_command con tu propio runner de tests.