概要
Claude Code の拡張機構(hooks / permissions / plugin system / skills / MCP)を AI エンジニアが自作で組むと数日かかる設定を、インストール 1 回で手元に落とせる外装プラグイン。GitHub リポジトリ: Chachamaru127/claude-code-harness
Claude Code には強力な拡張機構があるが、plugin.json / hooks.json / settings.json / .mcp.json / .claude-plugin/hooks.json の 5〜6 本の JSON を整合させながら自律運用のワークフローを組むのは現実的でない。Harness はこれを 1 パッケージで提供する。
v4.0.0 “Hokage” の主な変更点(2026-04-14)
| 改善点 | Before | After |
|---|---|---|
| フック実行速度 | ~300ms(bash → Node.js → TypeScript 3段ロケット) | ~10ms(Go バイナリ 1 本、30 倍速) |
| 設定ファイル数 | 5〜6 本を手動整合 | harness.toml 1 本(SSOT) |
| ガードレール R12 | warn | deny + Bash bypass 二重防御 |
| Node.js | 必要 | 不要(ネイティブバイナリ 3 本で配布) |
Go ネイティブ化の詳細
- pure-Go SQLite(
modernc.org/sqlite)採用で Node.js ランタイム要件を完全排除 bin/harnessがhooks.jsonから直接呼ばれ、フック 1 回 ~10msbin/harness syncでplugin.json/hooks.json/settings.jsonが全整合
harness.toml による SSOT
| |
ガードレール強化
- R12(保護ブランチへの直接 push)を
denyに格上げ - Claude Code 2.1.98 で発見された Bash permission bypass 2 種をハーネス側で二層目として塞ぐ
- defense in depth: CC 本体が塞いだ穴を Harness が再度塞ぐ構造
インストール
Claude Code v2.1.92 以上が必要。
| |
インストール後は /harness-plan で最初の依頼を指示する。
関連ページ
- Claude Code — Harness が拡張する対象
- ハーネスエンジニアリング — Harness が体現する設計概念
- マルチエージェント調整パターン — Plan → Work → Review の自律運用パターン