見出し画像

非エンジニアこそ使うべき！Claude Codeに「手綱（Harness）」をつけたらAIが優秀な部下に激変した話

れん学長｜AIツール実験室

こんにちは、れん学長です。（本記事は2026年1月6日時点の情報です）

AIを使ってコードを書かせるとき、「あれ？何作るんだっけ？」と迷子になったり、「気づいたら大事なファイルを消しそうになってた！」とヒヤッとした経験はありませんか？
あるいは、「とりあえず動くけど、中身がスパゲッティコードになって後で直せなくなった...」なんてことも。

私も正直、何度もそこで躓いてきました。
「AIは魔法の杖」だと思ってたけど、使いこなすにはこっちの指示力が問われるんですよね。

「もっと楽に、プロ品質のコードを書きたい」
そんな願いを叶えてくれるかもしれないツールがついに出たので、ガチで検証してみました。それが Claude Code Harness（クロード・ハーネス） です。

前回の記事では、その基礎編をお伝えしました↓

今回は、素のClaude Code（Player A）と、Harnessを入れた状態（Player B）で、全く同じタスクを競争させる実験をしてみました。
結果は、予想を遥かに超える「衝撃的な差」が出ましたので、その全貌をシェアしますね。

なぜ今、Harness（AIの手綱）が重要なのか？

生成AIは「指示待ち人間」になりがちです。言われたことはやるけど、言われないことは一切やらない。
「リサイズツール作って」と言えば、最低限動くコードは作ってくれます。でも、エラー処理は？テストは？使い方は？
そこまで気が回りません。

逆に、エンジニアが使うような複雑なプロンプトを毎回打つのも大変ですよね。

そこで登場するのが「Harness（手綱）」という概念です。
AIを自由にさせるのではなく、あえて「計画→実行→レビュー」という型（手綱）にはめることで、AIの能力を最大限に引き出す。
この逆説的なアプローチが、非エンジニアにこそ必要なんじゃないかなと思います。

使用ツール：Claude Code Harnessとは？

Claude Code Harnessは、Anthropic社の公式ツール「Claude Code」上で動く、茶々丸さんが開発したサードパーティ製のプラグインです。

個人開発でも「プロ品質」の開発フローを強制的に（でも優しく）回せるように設計されています。

主な特徴は以下の3つです：

  1. 計画（Plan）: いきなりコードを書かず、まず設計図を作る。

  2. 実行（Work）: 設計図に基づいて実装し、テストまで書く。

  3. レビュー（Review）: コードの品質やセキュリティをチェックする。

これらをコマンド一発で呼び出せるのが魅力ですね。

【実践】素のClaude vs Harnessあり、どっちが凄い？

今回は「Pythonで画像リサイズツールを作る」というシンプルなタスクで競争させてみました。

Player A：素のClaude Code

  • 指示：「このフォルダにある画像を50%にリサイズするツール作って」

  • 結果：

    • すぐにコードを書いてくれた（速い！）。

    • でも、コードはたった73行。

    • 「とりあえず動く」レベル。エラー処理は最低限。パスはハードコード（書き換えにくい）。

Player B：Harnessあり

  • 指示：同じ内容。

  • プロセス：

    1. まず「計画書（plans.md）」を作成。「環境構築→実装→テスト→ドキュメント」の手順を提示。

    2. 文句言わずに環境構築し、ライブラリ（Pillow）も選定。

    3. 実装だけでなく、テストコードも勝手に作成。

    4. README（説明書）まで自動生成。

  • 結果：

    • コードは181行（2.5倍！）。

    • 入力値チェック、例外処理完備。

    • コマンドライン引数で倍率を変えられる柔軟な設計。

使ってわかったメリット・デメリット

実際に比較して感じたことを、正直にまとめてみます。

ここが良かった！

  • 「勝手にここまで？」という感動: テストコードやREADMEまで自動で作られたときは、本当に「えっ！？」と声が出ました。

  • 安心感が段違い: 「これ消していい？」といちいち確認してくれるし、危ないコマンドはブロックしてくれる。

  • コードが「筋肉質」になる: 行数が増えたのは無駄な贅肉ではなく、エラー処理や拡張性といった「筋肉」がついた証拠でした。

ここは注意！

  • 最初は時間がかかる: 最初に初期設定（/harness-init）でいろいろ聞かれるので、走り出すまでは素のClaudeの方が速いです。

  • APIコスト: 計画やレビューで何度も往復するので、トークン消費量は増える傾向にあります（今回はプロプラン内でしたが）。

活用例

このツール、例えばこんなシーンで役立ちそうです。

  • 用途1: 納品物の作成

    • クライアントに渡すツールを作るとき、READMEやテストコードがあれば信頼性が爆上がりします。

  • 用途2: 久しぶりに触るコード

    • 3ヶ月後の自分が、「これどうやって動かすんだっけ？」とならないように、ドキュメントを残してくれます。

  • 用途3: 未知の言語への挑戦

    • 全く知らない言語でも、Harnessが「正しい作法」で書いてくれるので、勉強しながら開発できます。

🎬 動画で実際の操作画面をチェック！

この「勝手にテストコードが生成される瞬間」の気持ちよさは、文章だけだと伝わりにくいんですよね...。
実際のターミナル画面で、Claude Codeがどんな風に自律的に動くのか、動画でノーカットで見れます。
特に後半の比較パートは必見です！

▶️ 動画はこちら：【実験】Claude CodeにHarnessを入れたら「指示待ち」が「優秀な右腕」に変わった話

https://youtu.be/kvPUxFn0cBM
（1月7日18時公開予定）

まとめ：Harnessを試す価値はあるのか？

結論、非エンジニアの私たちが「ちょっと複雑なものを作ってみよう」と思った時には、これはもう必須級のツールだなと確信しました。

素のままのAIは「言われたことはやるけど、言われなかった不都合には対応してくれない」という限界があります。でも、人間がコマンドで「手綱（Harness）」を握り込んであげることで、AIが初めてプロの開発者のような「配慮」を持って動き出す。その差は、73行の「とりあえずコード」と、181行の「仕事でそのまま使える品質」という数字に如実に表れていました。

最初は少し設定に時間がかかるように見えるかもしれませんが、実際には5分程度。そのわずかな「急がば回れ」の手間をかけるだけで、その後のコード品質が劇的に上がり、手戻りが減る。この「AIが自律的に品質を底上げしてくれる感覚」は、一度味わうと戻れなくなるかもしれません。

次の一歩

まずはClaude Codeをインストール済みの方は、GitHubからHarnessプラグインを入れてみてください。
そして、簡単なツール作成でいいので `/plan-with-agent` コマンドを叩いてみる。
その瞬間、「あ、仕事のやり方が変わった」と感じるはずです。

一緒に、AIを使った新しい開発体験、楽しんでいきましょう！

この記事が役に立ったら、いいねやフォローで応援してもらえると嬉しいです。
ではまた次回！れん学長でした！

付録：実録・Claude Harness実践ガイド

今回の実験で実際に使用したコマンドと、スムーズに動かすための手順をまとめました。自分の環境で試す際の「チートシート」としてご活用ください。

1. 初期セットアップ

まず、プロジェクトディレクトリで Claude Code を起動します。

cd /path/to/your-project
claude

次に、以下の2行を Claude Code 内で実行してプラグインをインストールします。

/plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace

インストール後、初期化コマンドを叩きます。

/harness-init

※ 初回は「Soloモード」や「言語設定」を聞かれます。基本は「ソロモード」で、言語は「日本語（Japanese）」を選べばOKです。

2. プロ品質で開発する3ステップ

AIに「手綱（Harness）」を握らせるための基本フローです。

Step 1: 計画を立てる

/plan-with-agent [作りたいものの指示]

例：`/plan-with-agent 画像を50%にするツールを作って`
→ いきなり書かずに `plans.md` を作成させ、工程を整理させます。

Step 2: 実行（一括実装）

/work

→ `plans.md` の内容に従って、AIが自律的にコード、テスト、READMEまで書き上げます。

Step 3: レビュー（品質チェック）

/harness-review

→ コードの脆弱性や型ヒント、パフォーマンスをAIが客観的に評価し、改善案を提示してくれます。

3. トラブルを防ぐコツ

  • 危ないコマンドは止めてくれる: AIが勝手に削除コマンド（rm -rfなど）を打とうとすると、Harnessが一旦止めて承認を求めてきます。

  • 指示が曖昧な時は聞き返してくれる: 計画フェーズで「ここはどうしますか？」と深掘りしてくれるので、設計ミスが減ります。

#AI #ClaudeCode #ClaudeHarness #自動化 #生産性向上 #AIツール #クリエイター向け #プログラミング

いいなと思ったら応援しよう！

れん学長｜AIツール実験室 よろしければ応援お願いします！いただいたチップは、新しいAIツールの検証費用に使わせていただきます🧪 これからも実験→発見を共有していきますね！