概要
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
# harness.toml を書いて
$ bin/harness sync
# plugin.json / hooks.json / settings.json が全て整合ガードレール強化
- R12（保護ブランチへの直接 push）を
denyに格上げ - Claude Code 2.1.98 で発見された Bash permission bypass 2 種をハーネス側で二層目として塞ぐ
- defense in depth: CC 本体が塞いだ穴を Harness が再度塞ぐ構造
インストール
Claude Code v2.1.92 以上が必要。
# Claude Code を起動した状態で
/plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace
/harness-setup
# 更新
/plugin update claude-code-harnessインストール後は /harness-plan で最初の依頼を指示する。
関連ページ
- Claude Code — Harness が拡張する対象
- ハーネスエンジニアリング — Harness が体現する設計概念
- マルチエージェント調整パターン — Plan → Work → Review の自律運用パターン