Claude Code チームが教えるこの2つのつまみの使い方：1つは「できるかどうか」を、もう1つは「どこまでやる気があるか」を司る
- Anthropicの開発者向けアカウント@ClaudeDevsが2026年7月8日に長文を公開、著者はClaude Codeチームのメンバー Lydia Hallie（@lydiahallie）。
- effort（努力度）は、このタスクでClaudeがどれだけの作業をトータルで行うかを制御する：どれだけ考え、どれだけファイルを読み、どれだけテストを走らせ、どれだけ検証し、どこまで多段階に進めてから聞き返すか。API側でよく見る5段階：low / medium / high / xhigh / max；多くのタスクはモデルのデフォルト段階で十分。
- モデル設定はどのセットの訓練済みの凍結された重みを使うかを決める、つまり「何を知っているか」；effortは「どこまで徹底的にやるか」を決める。答えが間違っていたらまずコンテキストを確認し、次に問う：「できない」のか「本気を出していない」のか？
- 役割の例え：Fableは専門医のよう、Opusは専門家のよう、Sonnetは頼れる総合診療医のよう；effortは彼らがあなたのこの案件にどれだけ時間をかける気があるか。
- シンプルなタスクでは大きいモデルの方が高くつく；難しい多段階タスクでは大きいモデルの方が総合的な支払いが低くなることもあり、小さいモデルでは終えられない仕事もこなせる。Opus 4.8のデフォルトeffortはテストにおいて4.7のデフォルトのtoken量とほぼ同等で、効果はより良い。
2つのつまみ、どちらも「答えを良くする」ように見える
2026年7月8日、Anthropicの開発者アカウント@ClaudeDevsがClaude Codeの長文を投稿した、著者はClaude Codeチームのメンバー Lydia Hallie。
effortとは何か：同じモデルで、この案件をどこまで徹底的にやるか
Claude Codeでは、effort（努力度）はモデル選択と並ぶ設定である。それはモデルが「できるかどうか」を変えるのではなく、同じモデルセットに、今回どれだけ手間をかけてから提出するかを伝えるだけだ。よくある誤解はeffortを「より長く考える」ことだと理解すること；実際にそれが司るのは、この作業全体をどこまで徹底的にやるかである。
原文には率直に書かれている：effortが制御するのはこの一回のリクエストでClaudeがトータルでどれだけの作業を行うかであり、どれだけ長く考えるかだけでなく、以下も含む：
ソースコード、設定、ログを多く開くか、それとも対話ボックスに入れたその数段落だけを見るか
修正後にテストを走らせるか、結論を見直すか、境界のケースを自分でもう一度確認するか
多段階のタスクを一気にどこまで進めるか、それともすぐに止まってあなたにコンテキストの補足を聞くか
まず計画を書くかどうか、計画がどれだけ深いか、答えを見つけた後にもう一段検証するかどうか
APIドキュメントでは、effortは行動シグナルであり、硬直的なtoken上限ではない：低段階でも本当に難しい問題に遭遇すれば依然として考える可能性はあるが、同じ問題において高段階に比べて「考える量が少なく、動く量が少ない」。公式が挙げている段階は、省エネから徹底まで大まかに5段階である（Claude Codeの画面ではマルチエージェント権限と結びついたultracodeのような入口も見られるが、それは製品側の組み合わせであり、API段階名がもう1つ増えたわけではない）。