文档

一条命令安装 Codna。

Python 3.10 或更新版本，macOS 或 Linux，以及 git。无需安装 Node、Docker 或服务器。

安装完整文档 (在新标签页中打开)GitHub App

完整参考

这一页带你完成安装并交付第一个修复。完整文档涵盖 CLI、审查、MCP 服务器、GitHub App、GitHub Action、配置和核心概念，位于 docs.codna.ai。

打开完整文档 (在新标签页中打开)

安装

用 pip、pipx 或 uv 从 PyPI 安装 CLI。一切都在你的机器上运行。登录以使用托管额度，或把你自己的提供商密钥存入操作系统钥匙串。

pip install codna
codna --version
codna key set anthropic

快速开始

先以零 token 理解一个仓库。然后让 Codna 修复某个具体 issue。

codna triage .
codna fix . --issue "the checkout test is failing"

CLI

Triage、fix、review 和 secure。每条命令都接受 --json，错误以 JSON 形式输出到 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 服务器

安装 mcp extra，然后用一条命令把 Codna 加入 Cursor 或 Claude。五个工具：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 审查每一个 pull request。将安装关联到 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

常见问题

什么会离开我的机器？ 只有证据包或 diff，通过你的密钥发送给模型提供商。Triage 和回忆离线运行。

我在哪里报告缺陷？ 运行 codna report。它会提交到公开的反馈仓库；没有 token 时则回退到预填好的 issue 链接。

常见问题

pip install codna、pipx install codna 或 uv tool install codna。你需要 Python 3.10 或更新版本、macOS 或 Linux，以及 PATH 中的 git。CLI 用你自己的模型密钥在本地运行。

Cursor 和 Claude。安装 mcp extra，然后运行 codna mcp install --client cursor 或 --client claude。服务器永远不会把凭据写入你的编辑器配置。

App 运行同样的 codna 命令，由 Codna 托管。它审查每一个 pull request，响应 @codna review，当具有写权限的协作者在某个发现下回复 @codna fix 时打开修复，并对 codna-fix 和 codna-secure 标签以及红色检查套件做出响应。

CLI 在你的机器上运行。你的提供商密钥存在操作系统钥匙串中，从不打印。只有证据包或 diff 会送达模型提供商。在 codna.yaml 中把 privacy.egress 设为 fail-closed，Codna 就只在内核级网络拒绝之下运行你的测试，并在审查期间不做任何注册表查询。

在 87 个配对案例中对比 Cursor，Codna 每个已验证修复平均 16,159 个 token、约 $0.02 的模型花费，token 少 5 倍、速度快 1.7 倍。

仓库地图基于导入模式构建，因此不绑定某一种语言。设备端回忆覆盖 Python、JavaScript、TypeScript、Go、Rust、Java、C、C++、C#、PHP 和 Ruby。把 fix.test_command 设为你自己的测试运行器。