常见问题
应该使用哪个 AI 代理？
推荐使用 Claude Code。它在代码理解和生成方面能力最强。如果你已有 OpenAI 或 Google 的 API 密钥，Codex 和 Gemini CLI 也是不错的选择。你可以安装多个代理，并在每个 Issue 中自由选择。
可以同时运行多个代理吗？
可以。BKD 支持并行运行多个代理会话，通过 MAX_CONCURRENT_EXECUTIONS 设置控制（默认：5）。每个会话都有独立的 git 工作树，代理之间不会互相干扰。
需要付费吗？
BKD 本身是免费开源的，但 AI 代理需要各自提供商（Anthropic、OpenAI 或 Google）的 API 密钥。费用由提供商根据使用量计费。
BKD 会将我的代码发送到外部服务器吗？
BKD 完全运行在本地机器上。唯一的外部通信是 AI 代理与其 API 提供商之间的通信（例如 Claude Code 将提示词发送到 Anthropic 的 API）。你的代码和项目数据不会通过 BKD 本身离开你的机器。
如何更新 BKD？
启动器会自动处理更新。当有新版本可用时，启动器会将更新包下载到 data/updates/ 并解压到 data/app/。重新启动 BKD 即可获取最新版本。
可以修改端口吗？
可以。设置 API_PORT 环境变量或添加到 .env 文件中：
API_PORT=8080代理执行失败怎么办？
Issue 会保持在当前列中。你可以在聊天面板中查看代理的输出和错误信息。常见原因包括：
- API 密钥缺失或无效
- 网络连接问题
- 代理未安装（需要
npm install -g） - API 配额不足或触发速率限制
你可以重试执行或发送后续消息引导代理。
代理工作时可以编辑文件吗？
不建议。每个代理在独立的 git 工作树中工作，但如果你在同一分支中修改文件，可能会遇到合并冲突。建议等待代理完成，审查 diff，然后再进行自己的修改。
如何清理旧的工作树？
已完成会话的工作树可以安全删除：
rm -rf worktrees/BKD 会在需要时重新创建工作树。更多清理选项请参阅数据说明页面。
BKD 支持代理上网吗？
BKD 本身不需要互联网访问。但 AI 代理需要访问其 API 端点。通过标准环境变量配置代理：
HTTPS_PROXY=http://proxy.example.com:8080
HTTP_PROXY=http://proxy.example.com:8080可以使用私有/自托管模型吗？
BKD 目前支持 Claude Code、OpenAI Codex 和 Gemini CLI 作为执行引擎。如果你的自托管模型兼容这些 CLI 工具之一（例如通过自定义 API 基础 URL），可能可以使用。请查阅相应代理的文档了解自定义端点配置。
项目/Issue 数量有上限吗？
没有硬性限制。BKD 使用 SQLite，可以处理数百万条记录。实际限制取决于你的磁盘空间和内存。对于拥有数千个会话的大型项目，建议定期清理旧的会话数据。