Claude Code

Buggazi + Claude Code

编程智能体的项目管理工具。像 git 一样简单，30 秒搞定。

Claude Code Cursor Cline Windsurf Aider Codex 百度 Comate DeepSeek Coder Claude Web / Raycast

第 1 步：安装并注册

npm install -g buggazi
bgz signup my-project --local

API Key 会保存到项目目录的 .bgz/config.json。Key 立即生效，享有完整访问权限，有效期 48 小时。无需信用卡或邮箱即可马上开始记录 bug 和 features。在窗口关闭之前，你的负责人打开试用链接（$0 信用卡验证）启动 7 天免费试用；同一个 Key 继续有效，数据完整保留，无需重新注册。

已有 Key？直接运行：bgz login --local --key YOUR_KEY

由 Buggazi 用户推荐？在 signup 时加上 --ref BGZ-REF-XXXX：试用期从 7 天延长到 14 天。

无需 --api-url，默认连接 buggazi.ai。

建议把 .bgz/ 加到 .gitignore，避免误提交 API Key。

第 2 步：写入 CLAUDE.md

把以下内容添加到项目的 CLAUDE.md 文件中，Claude Code 启动时会自动读取并使用 Buggazi：

## Buggazi
本项目使用 Buggazi 进行 Bug 跟踪与功能规划。
使用 `bgz` CLI。配置在 .bgz/config.json（自动加载）。
未配置时：bgz login --local --key YOUR_KEY

运行 `bgz init --agent-schema` — 它会返回每个命令 + 有效参数。
这是唯一权威来源：schema 中没有的，不要使用。

第 3 步（推荐）：安装 schema 门禁 hooks

bgz init --claude-hooks

仅适用于 Claude Code。会把两个 hook 脚本写入 .claude/，并注册到 .claude/settings.json（已有的 hooks 会被保留；Claude Code 首次启动时会请你确认是否启用项目 hooks）：

SessionStart 刷新实时 agent-schema，并提醒 Agent 本项目在 Buggazi 中管理工作。PreToolUse 在每条 bgz 命令执行前用该 schema 校验：编造的命令或子命令会被拦截，错误信息中直接给出正确的命令，Agent 在同一回合内即可自我纠正，而不是浪费一次失败的执行。对 Buggazi API 的原始 curl 写请求也会被引导回 CLI 或远程 MCP。

设计上 fail-open：如果 bgz 或 schema 文件不可用，一切照常放行，绝不会阻塞你的会话。--print 只预览不写入，--force 会覆盖你已修改的副本重新生成。

把 .claude/ 提交到仓库，团队每个成员的 Claude Code 都会自动启用这些 hooks。.bgz/ 保持在 .gitignore 中。其他 Agent（Cursor、Cline、Aider、Web）继续使用 CLAUDE.md / AGENTS.md。

第 4 步：开始使用

直接用自然语言告诉 Claude Code 你想做什么——它会通过 bgz init --agent-schema 发现命令，并自动创建 Bug、功能和冲刺。加上 --project KEY 可按项目分组（未知的 key 会自动创建项目，所有套餐均不限项目数量）。

进阶：分发到 GitHub

Buggazi 是持久的记录；GitHub 的 issue 和 PR 是可丢弃的执行产物。你可以把一个 bgz Bug 分发为 GitHub issue，触发 GitHub Actions 中的 Claude Code：agent 打开 PR，你把 PR 状态同步回 bgz 条目，本地验证、合并，然后在 bgz 中解决。只有 backend/logic/api 类别的条目走无人值守模式；视觉类工作始终由人眼把关。完整模式（路由、轮询、工作流限制、订阅认证）见 llms.txt 的 "GitHub Bridge" 一节。