完全なリファレンス
このページでインストールから最初の修正の出荷まで進めます。CLI、レビュー、MCP サーバー、GitHub App、GitHub Action、設定、コア概念を扱う完全なドキュメントは docs.codna.ai にあります。
ドキュメント
Codna を 1 コマンドでインストール。
Python 3.10 以降、macOS または Linux、そして git。Node、Docker、サーバーのインストールは不要。
インストール
pip、pipx、uv で PyPI から CLI をインストール。すべてあなたのマシン上で動作します。管理割り当てを使うならサインイン、または自分のプロバイダーキーを OS のキーチェーンに保存してください。
pip install codna codna --version codna key set anthropic
クイックスタート
まずリポジトリをトークンゼロで理解します。次に特定の Issue の修正を Codna に頼みます。
codna triage . codna fix . --issue "the checkout test is failing"
CLI
Triage、fix、review、secure。すべてのコマンドは --json を受け付け、エラーは stderr に JSON で出力されます。
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 サーバー
mcp エクストラをインストールし、1 コマンドで Codna を Cursor または Claude に追加。5 つのツール：codna_triage、codna_fix、codna_secure、codna_recall、codna_report_bug。
pip install "codna[mcp]" codna mcp install --client cursor codna mcp install --client claude
GitHub App
アカウントまたは組織に App をインストールし、リポジトリを選びます。Codna はすべてのプルリクエストをレビューします。管理された修正にはインストールを Codna アカウントにリンクするか、自分のキーを追加してください。
# 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 にモデルプロバイダー、プライバシー設定、テストコマンドを記述します。シークレットの秘匿は常時オンです。
model: provider: anthropic key: env:ANTHROPIC_API_KEY privacy: egress: fail-closed redact_secrets: true fix: test_command: pytest -q
FAQ
マシンから出ていくものは？ エビデンスバンドルまたは diff だけが、あなたのキーでモデルプロバイダーに送られます。Triage とリコールはオフラインで動作します。
バグはどこに報告しますか？ codna report を実行します。公開フィードバックリポジトリに登録し、トークンがない場合は事前入力された Issue リンクにフォールバックします。
よくある質問
pip install codna、pipx install codna、または uv tool install codna。Python 3.10 以降、macOS または Linux、PATH 上の git が必要です。CLI は自分のモデルキーでローカルに動作します。
Cursor と Claude。mcp エクストラをインストールし、codna mcp install --client cursor または --client claude を実行します。サーバーがエディタ設定に認証情報を書き込むことはありません。
App は Codna がホストする環境で同じ codna コマンドを実行します。すべてのプルリクエストをレビューし、@codna review に応答し、書き込み権限を持つコラボレーターが検出に @codna fix と返信すると修正を開き、codna-fix と codna-secure ラベル、および赤いチェックスイートに反応します。
CLI はあなたのマシン上で動作します。プロバイダーキーは OS のキーチェーンにあり、表示されることはありません。モデルプロバイダーに届くのはエビデンスバンドルまたは diff だけです。codna.yaml で privacy.egress を fail-closed に設定すると、Codna はカーネルレベルのネットワーク遮断の下でのみテストを実行し、レビュー中にレジストリ照会を行いません。
Cursor との 87 件の対応ケースで、Codna は平均 16,159 トークン、検証済み修正 1 件あたり約 $0.02 のモデル費用で、トークン 5 分の 1、1.7 倍高速でした。
リポジトリマップはインポートパターンから構築されるため、特定の言語に縛られません。オンデバイスリコールは Python、JavaScript、TypeScript、Go、Rust、Java、C、C++、C#、PHP、Ruby に対応します。fix.test_command に自分のテストランナーを設定してください。