深掘り・小互解説

Claude Code チームが教える二つのつまみ：一つは「できるか」、もう一つは「どこまでやるか」

ClaudeDevs の長文解説。どちらも「答えを良くする」ように見える2つのノブを分解：モデル変更は凍結された重みのセットを切り替え、effort 調整はファイル読み込み、テスト実行、検証を追加で行ってから提出するかの意欲を制御する
要点
  • Anthropic の開発者向けアカウント @ClaudeDevs が2026年7月8日に長文を公開。著者は Claude Code チームのメンバー、Lydia Hallie（@lydiahallie）氏。
  • effort（努力の度合い）は、今回のタスクで Claude が全体としてどれだけの仕事をするかを制御する：思考の深さ、ファイル読み込みの多さ、テスト実行、検証、そしてユーザーに問い返すまでにマルチステップタスクをどこまで進めるかなど。API 側では一般的に low / medium / high / xhigh / max の5段階があり、多くのタスクではモデルのデフォルト設定で十分。
  • モデル設定は、どの訓練済み凍結重みセットを使うか、つまり「何を知っているか」を決定する。effort は「どれだけ徹底的にやるか」を決定する。間違った答えが出たら、まずコンテキストを確認し、次に「できないのか」それとも「全力を尽くさなかったのか」を問う。
  • 役割の比喩：Fable は専門医、Opus はエキスパート、Sonnet は信頼できる総合診療医。effort は、彼らがあなたの案件にどれだけの時間を費やす意思があるかを示す。
  • 簡単なタスクでは大規模モデルの方が高価。難しいマルチステップタスクでは、大規模モデルの方が総コストが低くなることがあり、小規模モデルでは完了できないタスクもこなせる。テストでは、Opus 4.8 のデフォルト effort は、Opus 4.7 のデフォルトとほぼ同等の token 量で、より良い結果を出した。
⚑
原文は Anthropic の Claude Code チームメンバーによる製品メカニズムの説明であり、第三者によるレビューではありません。文中の「約7倍の token」「コスト曲線」の図は概念図であり、実際のベンチマークデータではないと明記されています。Fable / Opus / Sonnet の役割の比喩も著者自身の表現です。文中の5段階の effort の名称と位置づけは公式の Effort API ドキュメントに基づいています。「ログイン500エラー」の各段階の例は、理解を助けるための教育的なシナリオであり、メーカーによる各段階での実測記録ではありません。
1背景

2つのノブ、どちらも「答えを良くする」ように見える

2026年7月8日、Anthropic の開発者向けアカウント @ClaudeDevs が Claude Code に関する長文を公開しました。著者は Claude Code チームのメンバー、Lydia Hallie 氏です。

Claude Code を使う際、モデルのグレードと effort（努力の度合い）はどちらも結果を良くするように見えます。片方は「できるか」を、もう片方は「十分やろうとするか」を管理します。
⚑
多くの人は、より大きなモデル（例えば Fable）を選べば Sonnet より賢い、effort を上げれば単に「より長く考える」だけだと考えがちです。最初の文は概ね正しいですが、2番目の文は不十分です。まず effort 自体を理解して初めて、「モデルを切り替えるか、effort を調整するか」という問いに意味が出てきます。
2まず effort を理解する

effort とは何か：同じモデルで、この仕事をどれだけ徹底的にやるか

Claude Code では、effort（努力の度合い）はモデル選択と並列の設定項目です。これはモデルの「能力」を変えるのではなく、同じモデルに対して「今回はどれだけ手間をかけてから提出するか」を指示します。よくある誤解は effort を「より長く考える」ことだと捉えることですが、実際にはタスク全体をどれだけ徹底的にこなすかを管理します。

原文は明確です。effort が制御するのは、今回のリクエストで Claude が全体としてどれだけの仕事をするかであり、思考時間だけでなく、以下の点も含まれます：

ファイル読み込み

ソースコード、設定、ログを複数開くか、対話ウィンドウに貼り付けた断片だけを見るか

検証

修正後にテストを実行するか、結論を再確認するか、エッジケースを自ら見直すか

どこまで進めるか

マルチステップのタスクを一度にどこまで進めるか、それともすぐに止まって追加のコンテキストを求めるか

思考と計画

最初に計画を立てるか、その計画はどのくらい深いか、答えを見つけた後にもう一段階検証を行うか

effort はアクセルであり、エンジン交換ではない 同じ車（同じモデル）でアクセルを深く踏めば、一度の走行でより長く走り、より多くチェックする 低 effort 早期提出・token 節約 ファイル読み込み テスト実行 自律的進行 まず質問を好む 高 effort 作業量増・確信度の高い提出 ファイル読み込み テスト実行 自律的進行 まず自力で把握してから質問
概念図：effort を上げることは、より強力なモデルに交換することではなく、同じモデルが今回のタスクでより多く読み込み、検証し、作業を進める意欲を持つことです。バーの長さは概念を示すもので、公式の測定値ではありません。

API ドキュメントによれば、effort は行動シグナルであり、厳密な token 上限ではありません。低設定でも本当に難しい問題に直面すれば思考する可能性がありますが、同じ問題に対して高設定よりも「思考も行動も少なく」なります。公式にリストされているレベルは、省エネから最大までおよそ5段階です（Claude Code のインターフェースでは、マルチエージェント権限と結びついた ultracode のようなエントリーも見られますが、それは製品側の組み合わせであり、別の API レベル名ではありません）。