A referência completa
Esta página deixa você instalado e entregando uma primeira correção. A documentação completa cobre a CLI, review, o servidor MCP, a GitHub App, a GitHub Action, configuração e conceitos centrais em docs.codna.ai.
Docs
Instale o Codna com um comando.
Python 3.10 ou mais recente, macOS ou Linux, e git. Sem Node, Docker ou servidor para instalar.
Instalar
Instale a CLI do PyPI com pip, pipx ou uv. Tudo roda na sua máquina. Entre para o crédito gerenciado, ou guarde sua própria chave de provedor no chaveiro do sistema.
pip install codna codna --version codna key set anthropic
Início rápido
Primeiro, entenda um repo por zero tokens. Depois peça ao Codna para corrigir uma issue específica.
codna triage . codna fix . --issue "the checkout test is failing"
CLI
Triage, fix, review e secure. Todo comando aceita --json, e os erros chegam como JSON no 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
Servidor MCP
Instale o extra mcp e adicione o Codna ao Cursor ou ao Claude com um comando. Cinco ferramentas: codna_triage, codna_fix, codna_secure, codna_recall e codna_report_bug.
pip install "codna[mcp]" codna mcp install --client cursor codna mcp install --client claude
GitHub App
Instale a App na sua conta ou organização e escolha os repositórios. O Codna revisa todo pull request. Vincule a instalação a uma conta do Codna para correções gerenciadas, ou adicione sua própria chave.
# On a pull request @codna review # Reply on a Codna finding (write access) @codna fix # On an issue label: codna-fix · codna-secure
Configuração
O codna.yaml guarda o provedor de modelo, as configurações de privacidade e o seu comando de teste. A redação de segredos está sempre ativa.
model: provider: anthropic key: env:ANTHROPIC_API_KEY privacy: egress: fail-closed redact_secrets: true fix: test_command: pytest -q
FAQ
O que sai da minha máquina? Só o pacote de evidências ou o diff, enviado ao seu provedor de modelo com a sua chave. Triage e recall rodam offline.
Onde reporto um bug? Rode codna report. Ele registra no repositório público de feedback e, sem token, recorre a um link de issue pré-preenchido.
Perguntas frequentes
pip install codna, pipx install codna ou uv tool install codna. Você precisa de Python 3.10 ou mais recente, macOS ou Linux e git no PATH. A CLI roda localmente com a sua própria chave de modelo.
Cursor e Claude. Instale o extra mcp e rode codna mcp install --client cursor ou --client claude. O servidor nunca grava credenciais na configuração do seu editor.
A App roda os mesmos comandos codna, hospedada pelo Codna. Ela revisa todo pull request, responde a @codna review, abre uma correção quando um colaborador com acesso de escrita responde @codna fix em um achado, e age sobre os rótulos codna-fix e codna-secure e sobre check suites vermelhas.
A CLI roda na sua máquina. Sua chave de provedor fica no chaveiro do sistema e nunca é impressa. Só o pacote de evidências ou o diff chega ao seu provedor de modelo. Defina privacy.egress como fail-closed no codna.yaml e o Codna roda seus testes só sob bloqueio de rede em nível de kernel e não faz consultas ao registro durante a revisão.
Em 87 casos pareados contra o Cursor, o Codna teve média de 16.159 tokens e cerca de US$ 0,02 de gasto de modelo por correção verificada, 5× menos tokens e 1,7× mais rápido.
O mapa do repositório é construído a partir de padrões de import, então não está preso a uma linguagem. O recall no dispositivo cobre Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP e Ruby. Defina fix.test_command com o seu próprio runner de testes.