WHATISAI｜第1章

Claude Code とは
「ハーネス」である

多くの人は、Claude Code を「賢いチャットの、ターミナル版」だと思っています。それは半分しか当たっていない。 Claude Code の本体は、賢さ（モデル）ではなく、その賢さを信頼できる仕事に変える足場──「ハーネス」のほうにあります。

一本の式からAgent ＝ Model ＋ Harness

2026年、OpenAI の Ryan Lopopolo らが「人間がゼロ行書いた100万行超のコードベース」を5ヶ月で作った経験から、一つの式を定式化しました。

\textbf{Agent} \;=\; \textbf{Model} \;+\; \textbf{Harness}

この式は要するに

Model（Claude本体）は、ただの推論エンジン ── 次の一語を確率で予測するだけ。Harness（＝Claude Code）は、そのモデルを取り巻く足場の総体：ツール・コンテキスト・検証ループ・権限・環境。モデルは買えるが、ハーネスは engineer するしかない。そして実務の性能は、ほとんどハーネス側で決まる。

Anthropic は、エージェントの振る舞いを決める4要素を「モデル本体・ハーネス（指示とガードレール）・ツール・環境」と整理しています。あなたが Claude Code で日々さわっている CLAUDE.md・サブエージェント・hooks・permissions ── あれは全部、ハーネスを engineer する操作だったのです。

なぜ足場が要るのかモデル単体は「賢いが、保証しない」

前提として、Claude（モデル）の性質を正確に押さえます。これは前作「AIの3つのクセ」の核そのもの:

予測のクセ ── 次の一語を確率で予測するだけ。事実を調べているのではない。だから知らないAPIも"それらしく"でっち上げる（ハルシネーション）。
文脈のクセ ── 出力は、与えた文脈に条件づけられる。だから何を文脈に入れるかで、別人になる。
ゆらぎのクセ ── 確率から選ぶたびに、答えが揺らぐ。

Karpathy はこれを「ジャギー（ギザギザ）な知能」と呼びました。ある瞬間は驚くほど有能で、次の瞬間は初歩でつまずく。この不安定な賢さを、そのまま本番に流すと破綻を招く（序章のLovableの例）。だから足場（ハーネス）で囲い込む必要がある。

ハーネスの一番の仕事 ── 「推測」を「検証」に変える

モデルは"もっともらしいコード"を推測する。でも正しいかは保証しない。ハーネスは、その推測を「テストが通った／通らない」という決定論的な判定に接続する。Claude Code がコードを書き、自分でテストを実行し、失敗を見て直す ── あの一連が、推測を検証に変えるハーネスの心臓部です。

まず予想してみる

コードを任せるとき、Claude Code が素のチャットより信頼できる、いちばんの理由は？

この資料の地図ハーネスを操る、4本のレバー

では、ハーネスを engineer するとは具体的に何をするのか。本質は4本のレバーに集約されます。以後の各章は、この一本ずつを Claude Code の機能に落として掘ります。

①文脈

何を入れ、何を入れないか（CLAUDE.md・/compact）。コンテキストは有限で腐る。→ 第2章

②検証

推測を、テスト合格という決定論につなぐ（hooks・検証サブエージェント）。→ 第3章

③分割

小さく刻み、サブエージェントで文脈を隔離する。多エージェントの最前線へ。→ 第4章

④舵

人が握る（permissions・最小特権・いつ手で書くか）。→ 第5章

発展発展：用語の系譜（prompt → context → harness engineering）▼ 数式が苦手な方は飛ばしてOK

この「足場を engineer する」という発想は、段階的に名前を変えてきました。置き換えではなく、より上位の層が積み上がる構造です。

① プロンプトエンジニアリング（2022-2024）：一度の入力から最良の出力を引き出す（・）。単発のやり取りが対象。

② コンテキストエンジニアリング（2025〜）：Karpathy が2025年6月に定義 ──「次の一歩のために、ちょうど良い情報でコンテキストウィンドウを満たす技術」。単発から、文脈の動的な構成へ。

③ ハーネスエンジニアリング（2026〜）：Mitchell Hashimoto や OpenAI が、ほぼ同時期に同じ語で言語化（用語自体はまだ確立途上）。「エージェントが間違えるたび、二度と同じ間違いをしないよう仕組みを作り込む」（Hashimoto）。Agent = Model + Harness。

⚠ 時点依存・議論中：用語はまだ流動的（Karpathy は "agentic engineering"、Willison は "vibe engineering" と呼ぶ）。普遍なのは「モデルより、それを取り巻くシステムが性能を決める」という地盤であって、特定の呼び名ではない。出典: Karpathy(2025/6, Sequoia 2026)、Hashimoto "My AI Adoption Journey"、OpenAI "Harness Engineering"、Anthropic "Building Effective Agents"。

第1章のひとこと

あなたが engineer するのは、Claude（モデル）ではない。
Claude Code（ハーネス）のほうだ。

── モデルは数ヶ月で新しくなる。でも、あなたが磨いたハーネスの腕は、次のモデルでも効く。次章から、4本のレバーを一本ずつ握っていきます。