著者メモ：Claude Code では Fable の既定の effort が Medium である一方、API で effort を指定しないと Fable 5.2 の既定値は high になります。この違いを解説し、API 呼び出しで両者の使用量をそろえる方法を紹介します。
Claude Code で Fable 5.2 を使ってコードを書いていると、token 消費は意外と控えめに感じるものです。ところが同じモデル ID を API から呼び出すと、同じような作業なのに使用量が明らかに増えてしまう。そこで「2つの環境で動いているのは別のモデルでは？」と疑う開発者も少なくありません。本記事の結論は次のとおりです。Claude アプリと Claude Code の既定の effort は Medium、Claude API で effort を指定しない場合の Fable 5.2 の既定値は high です。
モデルが2つあるわけでも、課金に問題があるわけでもありません。 同じパラメータの既定値が、入口によって違うだけです。Anthropic は 2026-11-09 のリリース記事、Claude プラットフォームのモデルページ、Effort のドキュメントのいずれにもこの点を明記しています。
この記事で得られること：Claude Code と API で使用量が合わない理由がわかり、API リクエストで effort を明示的に指定して、両者のコストを同じ段階で比較する方法も身につきます。
Claude CodeのFableはデフォルトMedium、APIのデフォルトはhigh：核心ポイント
まず、2つの入口の違いを表にまとめます。表の情報はすべて、公式の発表記事、モデルページ、Effortドキュメントに基づいています。
| ポイント | 説明 | あなたへの影響 |
|---|---|---|
| Claude CodeのデフォルトはMedium | 公式の発表記事によると、MediumのeffortはClaudeアプリとClaude Codeのデフォルトです | Claude Codeで見ている使用量は、Mediumの使用量です |
| APIのデフォルトはhigh | モデルページの比較表では、Fable 5.2のDefault effortはhighです。これはClaude APIのeffortパラメータのデフォルト値を指します | APIリクエストにeffortを書かなければ、highで実行されます |
| 同じモデル | どちらもFable 5.2を呼び出しており、違いはeffortの段階だけです | 使用量の差をモデルバージョンの違いと誤解しないでください |
| 選択可能な段階 | Fable 5.2はlow、medium、high、xhigh、maxに対応しています | APIでも明示的にmediumを指定すれば、Claude Codeと揃えられます |
Claude CodeとAPIでFableの使用量が違うのはなぜ？
effortパラメータは、1つのタスクにモデルがどれだけ推論と出力を投入するかを制御します。段階が高いほど、モデルは通常、より十分に考えて内容を展開するため、消費トークンも多くなりがちです。段階が低いほど、モデルはより速く、より節約的に結果を返す傾向があります。Claude Codeは日常的なコーディングのやり取りが中心なので、効果と消費のバランスを取ってデフォルトをMediumにしています。
一方、Claude APIは開発者が直接組み込むためのインターフェースです。Fable 5.2のAPIにおけるeffortのデフォルト値はhighで、リクエストボディにeffortパラメータがなければ、サーバー側はhighとして処理します。Claude Codeを使っていた人がAPIへ移行する際に、base_urlとモデルIDだけを差し替えてeffortを付け忘れると、実際の実行段階がMediumからhighに上がってしまいます。
MediumがデフォルトのときのFable 5.2に関する公式の説明
Anthropicは2026-11-09の発表記事で、デフォルトのMedium段階では、Fable 5.2が難しいタスクを完了するのに使うトークンが5.1より少ないと述べています。これは公式の自己申告であり、第三者による再検証の結果ではありません。この説明はMedium段階の効率を示すものですが、highがMediumより何倍多く消費するかという共通の倍率は示されていません。
そのため、「highはMediumの数倍高い」といった数字を固定値として扱わないでください。タスクの複雑さ、コンテキストの長さ、出力の長さによって実際の差は変わります。確実な方法は、自分のタスクでmediumとhighをそれぞれ実行し、usageフィールドを比較することです。
Fable 5.2 の effort レベルと Claude Code のデフォルト Medium の比較
下の表は、Fable 5.2 がサポートする 5 つのレベルと、2 つの利用経路でのデフォルト値との関係をまとめたものです。各レベルの傾向は effort パラメータの一般的な意味合いを示したものです。実際の挙動は、お手元のタスクで返ってくる結果に基づいて判断してください。
| effort レベル | いずれかの経路でのデフォルトか | 一般的な傾向 | 向いているタスク |
|---|---|---|---|
low |
いいえ | 速く低コスト。推論への投入量は少なめ | 簡単な書き換え、フォーマット変換、分類 |
medium |
Claude アプリと Claude Code のデフォルト | 効果と消費のバランス型 | 日常的なコーディング、通常の質疑応答、バッチ処理 |
high |
Claude API のデフォルト（未指定時） | 推論がより十分で、消費は高めになりやすい | 複雑なデバッグ、アーキテクチャ分析 |
xhigh |
いいえ | high よりさらに多く投入 | 難易度の高い多段階推論 |
max |
いいえ | 最大の投入量 | 品質への要求が非常に高い、少数の重要タスク |
この表で注目してほしいのは、中央の 2 行です。Claude Code で得た使用量の感覚は medium によるもので、API でパラメータを指定しなかった場合に動くのは high です。Claude Code と同じ使い心地やコストを再現したいなら、API リクエストに medium を明示的に書く必要があります。
API で Fable 5.2 を Claude Code デフォルトの Medium に揃える方法
以下の手順にコードブロックはありません。順番に確認していけば大丈夫です。リクエストボディ内での effort フィールドの具体的な書き方は、Claude プラットフォームの Effort ドキュメントと、お使いのプラットフォームの API ドキュメントを参照してください。
ステップ 1：モデル ID と接続先を確認する
- APIYI のモデル料金ページ docs.apiyi.com/models で、Fable 5.2 に対応するモデル ID を確認します：
claude-fable-5-2 - エンドポイントには OpenAI 互換の base_url を使います：
https://api.apiyi.com/v1 - 同じ API キーで呼び出せるので、Claude 用に別のアカウントを申請する必要はありません
ステップ 2：effort パラメータを明示的に指定する
- Claude Code と揃えたい場合：effort を
mediumに設定します - より強い推論が必要な場合：
highに設定します。未指定時のデフォルト値でもあります - 単純な変換だけの場合：
lowを試して消費を抑えられます - デフォルト値には頼らないでください。頼ってしまうと、ログからそのリクエストがどのレベルで動いたのか分からなくなります
ステップ 3：usage フィールドで 2 つのレベルの使用量を比較する
- 同じタスク群を選び、
mediumとhighでそれぞれ 1 回ずつ実行します - 毎回の応答に含まれる入力トークン、出力トークン、キャッシュ読み取りトークンを記録します
- 単価をもとにコストを換算し、固定の倍率を当てはめるのではなく、自社の業務における実際の差を把握します
🚀 クイックスタート：effort レベルが使用量に与える影響を先に確かめたいなら、APIYI（apiyi.com）の新規ユーザー向け無料テスト枠で、medium と high の比較を一通り試せます。このプラットフォームでは 1 つのキーで Claude、OpenAI、Gemini などのモデルに対応しているので、あとからモデルを変えて比較するときも接続方法を変える必要はありません。
Fable 5.2 の API 価格と effort 使用量の関係
effort 自体は単価を変えません。影響するのは、1回のリクエストで消費する token の量です。つまり、コストの差は token 数の差に単価を掛けたものになります。下の表は、APIYI の価格ページに掲載されている 2026-11-11 時点のデータです。
| モデル ID | 入力 | 出力 | キャッシュ読み取り | グループ | データ日付 |
|---|---|---|---|---|---|
claude-fable-5-2 |
$8 | $40 | $0.2 | ClaudeCode 含む | 2026-11-11 |
価格の単位と最新の数値は、APIYI の価格ページ docs.apiyi.com/models のリアルタイム表示をご確認ください。表を見ると、出力単価は入力の 5 倍です。effort のレベルを上げると、モデルはより多くの推論と回答を出力する傾向があります。出力 token の単価が最も高いため、high レベルでのコスト増加は主に出力部分から生じます。
キャッシュ読み取りの単価は、入力よりもかなり低く設定されています。リクエストにシステムプロンプトや固定のコンテキストが大量に繰り返し含まれる場合、キャッシュを有効にすると入力側のコストを大きく抑えられます。ただし、キャッシュが効くのは入力部分だけです。effort を上げたことによる出力の増加までは相殺できません。
Fable 5.2 のコストを見積もる正しい方法
コストを見積もるとき、「high は Medium の何倍高い」という一言で予算を計算するのは避けましょう。公式が説明しているのは、2つの入口でのデフォルト値と、Medium レベルでは Fable 5.2 が 5.1 より token を節約できるという公式の自己申告の結論だけです。high と Medium の間の統一的な換算比率は示されていません。
より確実な方法は、実際の業務を代表する 20〜50 件のタスクを選び、2つのレベルでそれぞれ実行して、入力・出力・キャッシュ読み取り token の平均を集計することです。そのうえで上の表の単価を使ってタスク1件あたりの平均コストを計算すれば、ご自身の業務に当てはまる数字が得られます。
Fable 5.2 の使用量が合わないときの確認リスト
APIの使用量とClaude Codeの使用量に大きな差があるときは、下の表を上から順に確認してみてください。
| 現象 | 考えられる原因 | 対処方法 |
|---|---|---|
| API の使用量が Claude Code より明らかに多い | リクエストに effort が指定されておらず、デフォルトの high で動作している | 明示的に medium を設定して、もう一度比較する |
| effort を指定しても使用量が変わらない | フィールドの位置や名前がインターフェースの要件に合っておらず、無視されている | Effort のドキュメントとプラットフォームのインターフェースドキュメントを見て、フィールドの書き方を確認する |
| リクエストがパラメータエラーを返す | effort の値がサポート範囲外になっている | low、medium、high、xhigh、max のみを使う |
| モデル名でエラーになる | モデル ID のスペルが間違っている | APIYI の料金ページで claude-fable-5-2 を確認する |
| 両方とも medium なのに使用量に差がある | コンテキストの長さ、ツール呼び出し、キャッシュのヒット状況が異なる | 入力内容を固定してから比較し、キャッシュ読み取りの token は別に確認する |
最後の行は見落としやすいポイントです。Claude Code はコーディング中にファイルの内容や会話履歴を自動的に取り込みますが、自分で書いたAPIリクエストには、同じ量のコンテキストが含まれているとは限りません。effort が同じでも入力 token は変わることがあるため、比較するときは入力を固定しておくのがおすすめです。
よくある質問 FAQ
Q1：Claude Code の Fable と API の Fable 5.2 は同じモデルですか？
同じモデルです。違いは effort パラメータのデフォルト値にあります。Claude アプリと Claude Code ではデフォルトが Medium ですが、Claude API で effort を指定しない場合、Fable 5.2 は high で動作します。
Q2：API で effort を指定しないとどうなりますか？
サーバー側で、Claude API における Fable 5.2 のデフォルト値である high が適用されます。Claude Code から API に切り替えたあと、「使用量が増えた」と感じる方が多いのはこれが原因です。
Q3：high は Medium の何倍のコストになりますか？
公式からは統一的な倍率は示されていません。effort は単価そのものを変えるのではなく、token の消費量だけに影響します。消費量の差はタスクの難易度、コンテキスト、出力の長さによって変わります。ご自身のタスクで両方の設定を実行し、usage のデータから計算することをおすすめします。
Q4：Fable 5.2 ではどの effort レベルを使えますか？
Effort のドキュメントによると、Fable 5.2 は `low`、`medium`、`high`、`xhigh`、`max` の5段階に対応しています。日常的なコーディングなら `medium` で十分なことが多く、複雑な推論が必要な場合に、より高いレベルを検討するとよいでしょう。
Q5：API 経由で Fable 5.2 を呼び出し、effort を設定するにはどうすればいいですか？
次の3ステップで設定できます。
1. APIYI（apiyi.com）に登録して API キーを取得します。新規ユーザーには無料のテスト枠があります
2. base_url に `https://api.apiyi.com/v1`、モデル ID に `claude-fable-5-2` を指定します
3. リクエスト内で effort を明示的に指定します。フィールドの書き方は、Effort のドキュメントとプラットフォームの API ドキュメントに従ってください
Q6：APIYI での Fable 5.2 の価格はいくらですか？
2026-11-11 時点の価格データでは、`claude-fable-5-2` は入力 $8、出力 $40、キャッシュ読み取り $0.2 で、グループには ClaudeCode が含まれます。価格は変更されることがあるため、ご注文の前に APIYI の価格ページで最新の情報をご確認ください。
Q7：Medium では Fable 5.2 が 5.1 より token を節約できるという結論は信頼できますか？
これは Anthropic が 2026-11-09 の発表記事で公式に自己申告した内容で、難しいタスク全体での傾向を述べたものです。high と Medium を比較した数値は示されていません。コストを重視される場合は、やはりご自身のタスクのデータで検証することをおすすめします。
Q8：すべての API リクエストを medium に変更すべきですか？
必ずしもそうではありません。Claude Code と同じ使い心地とコストを再現したいなら、`medium` で十分です。複雑なデバッグや重要な分析には `high` を残し、簡単なタスクには `low` に下げるのもよいでしょう。大切なのは、レベルを明示的に指定し、デフォルト値に判断を任せないことです。
Claude Code の Fable は既定が Medium、API の既定は high ── Key Takeaways
- 同じモデルでも既定値が違う：Claude Code の既定は Medium ですが、API で effort を指定しない場合、Fable 5.2 は high で動きます
- 指定しないと high 扱いになる：API に移行するときに effort を付け忘れるのが、使用量が増える原因としていちばん多いパターンです
- 選べるのは5段階：Fable 5.2 は low、medium、high、xhigh、max に対応しています
- 決まった倍率はない：high と Medium の間に共通の換算比率は公式には示されていません。自分のタスクのデータで計算する必要があります
- コストは出力が支配的：出力単価は入力の5倍です。effort を上げたときの増分は、主に出力トークンから生じます
- 始めるのは簡単：APIYI の OpenAI 互換インターフェースとモデルID
claude-fable-5-2を使えば、段階ごとの比較ができます
まとめ
Claude Code の Fable は既定が Medium、API では指定しないと high になります。押さえておきたいポイントは次の3つです。
- 既定値が違う：Claude アプリと Claude Code の既定は Medium、Claude API 上の Fable 5.2 の既定は high です
- effort は明示的に設定する：Claude Code と挙動をそろえたいなら、API リクエストに
mediumを書いておきましょう - データでコストを見積もる：決まった倍率を当てはめず、usage フィールドと単価から、自分の環境での実際の差を計算してください
次のステップとして、実際のタスクをいくつか選び、medium と high の両方で実行してみることをおすすめします。結果はコストモデルに記録しておきましょう。まずは APIYI（apiyi.com）の無料枠でこの比較を済ませてから、本番環境の既定の段階を決めると安心です。
📚 参考資料
- Anthropic 発表記事：Fable と Mythos 5.2 のリリースノート、2026-11-09
- リンク：
anthropic.com/claude-fable-and-mythos-5-2 -
説明：Medium effort が Claude アプリと Claude Code のデフォルト設定である根拠と、Medium 時に 5.1 よりトークン消費が少ないという公式の自己申告値
-
Fable 5.2 モデルページ：モデルパラメータ対照表
- リンク：
platform.claude.com/docs/en/models/fable-5-2/overview -
説明：Default effort は high で、Claude API における effort パラメータのデフォルト値です
-
Effort ドキュメント：effort パラメータの説明
- リンク：
platform.claude.com/docs/en/build-with-claude/effort -
説明：Fable 5.2 が対応するレベルと、API のデフォルト値
-
APIYI モデル価格ページ：モデル ID と価格
- リンク：
docs.apiyi.com/models - 説明：
claude-fable-5-2の入力・出力・キャッシュ読み取りの価格とグループ情報（データ日付 2026-11-11）
著者：APIYI 技術チーム
技術交流：effort の設定や使用量の比較で困ったことがあれば、APIYI 公式サイトのトップページからお気軽にお問い合わせください。
