DEV Community

Cover image for クロードコードでのクロードソネット5活用術
Akira
Akira

Posted on • Originally published at apidog.com

クロードコードでのクロードソネット5活用術

Claude Sonnet 5は2026年6月30日にリリースされ、Claude Codeで使える強力なデフォルトモデルの1つです。Anthropicはこれを「これまでで最もエージェント的なSonnetモデル」と説明しており、発売時のベンチマークでも、ツール使用とエージェント型コーディングでOpus 4.8に近い結果を示しています。Claude Codeでは、モデルがファイルを読み、ターミナルコマンドを実行し、リポジトリを編集するため、この特性が特に重要です。

今すぐApidogを試す

この記事では、Claude CodeでSonnet 5を選択する方法、適応的思考による動作の変化、実装ワークフロー、Opus 4.8に切り替える判断基準を整理します。あわせて、モデルが推測でAPIを実装するのではなく、実際のAPI仕様とエンドポイントに対してテストできるように、Apidogと組み合わせる方法も紹介します。

Sonnet 5がClaude Codeの強力なデフォルトである理由

Claude Codeは、単に回答を返すチャットではありません。モデルが次のようなループを実行します。

  1. タスクを理解する
  2. 計画を立てる
  3. ファイルを読む
  4. コマンドを実行する
  5. ファイルを編集する
  6. テスト結果を読んで修正する

このため、Claude Codeでは「ツールを使いながら反復できるモデル」が重要です。Sonnet 5はこの用途に最適化されています。

Claude Sonnet 5 benchmark

Anthropicが報告した発売時点のベンチマークは次のとおりです。以下は報告値であり、独自検証結果ではありません。

ベンチマーク Sonnet 5 Opus 4.8 Sonnet 4.6
SWE-bench Pro（エージェント型コーディング） 63.2% 69.2% 58.1%
Terminal-Bench 2.1 80.4% 82.7% n/a
OSWorld-Verified（コンピュータ使用） 81.2% 83.4% 78.5%

ポイントは、ツールを使うタスクではSonnet 5がOpus 4.8に約1〜3ポイント差まで近づくことです。一方、ツールに頼らない純粋な推論ではOpusのほうが約6ポイントリードします。

Claude Codeでの通常の開発作業は、ファイル操作、コマンド実行、テスト実行を含むツール依存の作業です。そのため、多くのケースではSonnet 5がコスト効率の高いデフォルトになります。

価格面でも差があります。Sonnet 5の標準料金は入力100万トークンあたり3ドル、出力100万トークンあたり15ドルです。2026年8月31日までは導入価格として入力2ドル、出力10ドルで利用できます。Opus 4.8は入力100万トークンあたり5ドル、出力100万トークンあたり25ドルです。詳細はClaude Sonnet 5の料金詳細で解説しています。

Claude CodeでSonnet 5を選択する

Claude Codeでは、/modelコマンドでモデルを切り替えます。

/model
Enter fullscreen mode Exit fullscreen mode

モデルピッカーが表示されたら、Claude Sonnet 5を選択します。

直接指定する場合は、次のように入力します。

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

claude-sonnet-5は、日付サフィックスなしのAPIモデルIDです。Claude Codeをスクリプト化する場合や、プロジェクトのデフォルトモデルとして設定する場合は、このIDを使います。

Sonnet 5はリリース時点からClaude Codeで利用できます。また、無料版とPro版のClaudeアプリのデフォルトモデルであり、Max、Team、Enterpriseでも利用可能です。

関連情報は以下も参照してください。

Sonnet 5で変わった動作

Sonnet 5はSonnet 4.6からのアップグレードですが、Claude Codeで使う際に注意すべき動作変更があります。

適応的思考がデフォルトでオン

Sonnet 4.6では、thinkingフィールドがないリクエストは思考なしで実行されました。Sonnet 5では、適応的思考がデフォルトで有効です。

モデルはタスクの難易度に応じて、どれだけ推論するかを自動的に調整します。

  • 単純なリネーム: ほとんど思考しない
  • 複数ファイルのリファクタリング: より多く思考する
  • 仕様理解が必要な実装: 計画に時間を使う

Claude Codeでは、この設定を手動でAPIリクエストのように指定する必要はありません。Claude Codeがリクエストを管理します。

詳細はAnthropicの適応的思考に関するドキュメントを参照してください。

Sonnet 5は、low、medium、high、xhighの4段階のeffortパラメータもサポートしています。難しいタスクでは、手動の思考予算ではなく、このエフォート設定で推論の深さを調整します。

手動拡張思考とサンプリングパラメータが廃止

Claude APIを使った独自ツールを作っている場合は、次の変更に注意してください。

従来の手動拡張思考は使えません。

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  }
}
Enter fullscreen mode Exit fullscreen mode

Sonnet 5では、この形式は400エラーになります。代わりに適応的思考とeffortパラメータを使います。

また、以下のサンプリングパラメータをデフォルト以外に設定しても400エラーになります。

  • temperature
  • top_p
  • top_k

動作を制御したい場合は、プロンプトやシステム指示で制御します。Claude Code自体はこれらを処理しますが、Sonnet 4.6向けに書いたスクリプトは見直してください。

詳細はSonnet 5とSonnet 4.6の比較で確認できます。

新しいトークナイザーがコンテキストとコストに影響する

Sonnet 5は新しいトークナイザーを使います。同じソーステキストでも、Sonnet 4.6と比較して約30%多くのトークンが生成されます。つまり、約1.3倍です。

APIのリクエスト形式やレスポンス形式は変わらないため、既存処理がすぐ壊れるわけではありません。ただし、次の2点に影響します。

  1. 100万トークンのコンテキストウィンドウに入るテキスト量が減る
  2. 同じテキスト量でも、リクエストあたりのコストが増える可能性がある

Sonnet 4.6時代のトークン見積もりは再利用しないでください。予算を見積もる場合は、AnthropicのトークンカウントエンドポイントでSonnet 5向けに再カウントします。

Sonnet 5を使ったClaude Codeワークフロー

Sonnet 5は、いきなり編集させるよりも、先に計画を立てさせたほうが安定します。

おすすめの進め方は次のとおりです。

  1. タスクを説明する
  2. 関連ファイルを読ませる
  3. 編集前に計画を出させる
  4. 計画をレビューする
  5. 実装させる
  6. テストを実行させる
  7. 失敗したら出力を読ませて修正させる

Claude Codeでは、たとえば次のように依頼します。

このリポジトリでユーザー登録APIのバリデーションを改善してください。
まず関連ファイルを読み、変更計画を提示してください。
計画を確認するまでファイルは編集しないでください。
Enter fullscreen mode Exit fullscreen mode

計画に問題がなければ、次のように進めます。

この計画で実装してください。
実装後に関連するテストを実行し、失敗した場合は原因を説明して修正してください。
Enter fullscreen mode Exit fullscreen mode

適応的思考が有効なので、計画ステップのために手動で推論設定を増やす必要はありません。重要なのは、モデルに十分なコンテキストを与えつつ、リポジトリ全体を無駄に読ませないことです。

100万トークンのウィンドウがあっても、毎回リポジトリ全体を読み込ませるのは非効率です。まず関連ディレクトリやファイルに範囲を絞り、必要になったら追加で読ませるほうがコストを抑えられます。

APIを構築し、Sonnet 5にテストさせる

Claude CodeでREST APIを実装する場合、Sonnet 5はルート、コントローラ、バリデーション、テストコードを作成できます。ただし、実際のエンドポイントがAPI仕様どおりに動くかは、実行して検証する必要があります。

ここでApidogを組み合わせます。

実装フローは次のとおりです。

  1. ApidogでAPI仕様を定義する
  2. エンドポイント、リクエスト、レスポンススキーマを作る
  3. モックサーバーで期待レスポンスを用意する
  4. Claude CodeでSonnet 5に実装させる
  5. Apidogのテストシナリオを実行する
  6. 失敗結果をSonnet 5に読ませて修正させる

Apidog MCPサーバーを使うと、API仕様をモデルに参照させられます。これにより、Sonnet 5は推測ではなく、実際のスキーマに基づいてハンドラやテストを生成できます。

テスト実行の例です。

# Claude CodeのSonnet 5がエンドポイントを実装し、
# CLI経由でApidogテストスイートを実行します。
apidog run --access-token $APIDOG_TOKEN \
  --project-id $PROJECT_ID \
  --test-scenario "user-signup-flow"
Enter fullscreen mode Exit fullscreen mode

テストが失敗した場合、Sonnet 5に出力を読ませます。

Apidogのテスト結果を確認し、失敗しているアサーションの原因を特定してください。
API仕様と実装の差分を説明し、必要な修正を行ってください。
Enter fullscreen mode Exit fullscreen mode

この流れにより、次のループを作れます。

API仕様 → 実装 → テスト → 失敗解析 → 修正 → 再テスト
Enter fullscreen mode Exit fullscreen mode

モデルが「正しそうなコード」を書くだけでなく、実際のAPI契約に対して検証するのが重要です。まずはApidogをダウンロードして、ローカルでプロジェクトをセットアップできます。

Opus 4.8に切り替えるタイミング

Sonnet 5は多くのClaude Codeセッションで適切なデフォルトです。ただし、Opus 4.8を使うべき場面もあります。

Opus 4.8を使うべきケース:

  • ツール実行よりも純粋な推論が中心のタスク
  • 複雑なアルゴリズム設計
  • 微妙なロジックや仕様判断が必要な変更
  • 小さなミスが長い作業の中で蓄積しやすい自律タスク
  • コストより品質を優先する重要な変更

Sonnet 5を使うべきケース:

  • ファイル読み取り、編集、テスト実行を含む通常の開発作業
  • 多数の小さなタスクを高速に回したい場合
  • コストを抑えながらエージェント型コーディングを行いたい場合
  • API実装、リファクタリング、テスト修正などの反復作業

切り替えは簡単です。

/model claude-opus-4-8
Enter fullscreen mode Exit fullscreen mode

Sonnet 5に戻す場合:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

すべての作業を1つのモデルで進める必要はありません。難しい設計や判断だけOpus 4.8に切り替え、通常の実装やテスト修正はSonnet 5に戻す使い方が現実的です。

詳細はSonnet 5とOpus 4.8の比較を参照してください。過去にClaude CodeでSonnet 4.5やClaude CodeでFable 5を使っていた場合、ワークフローは近いものになります。

実践的なヒント

  • 編集前に計画を出させる。 重要な変更では、いきなり編集させず、関連ファイルを読ませて計画を確認します。
  • コンテキストを絞る。 100万トークンのウィンドウは大きいですが、新しいトークナイザーにより想定より早く埋まります。
  • トークンコストを再見積もりする。 Sonnet 4.6時代の見積もりは使わず、Sonnet 5で再カウントします。
  • APIは実際の契約に対してテストする。 Apidogのテストを実行し、実装が仕様どおりか確認します。
  • 難しいタスクだけOpus 4.8に切り替える。 通常作業はSonnet 5、複雑な推論はOpus 4.8という使い分けが効率的です。
  • サンプリング設定に頼らない。 Sonnet 5ではtemperatureなどの変更ではなく、プロンプトやシステム指示で制御します。

よくある質問

Claude CodeでClaude Sonnet 5は利用できますか？

はい。Sonnet 5は2026年6月30日のリリース以降、Claude Codeで利用できます。/modelコマンドでClaude Sonnet 5を選択するか、次のように指定します。

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

適応的思考のために設定変更は必要ですか？

いいえ。Sonnet 5では適応的思考がデフォルトで有効です。Claude Codeがリクエストを管理し、モデルがタスクごとに思考量を調整します。

Sonnet 4.6では、thinkingフィールドがないリクエストは思考なしで実行されました。この点がSonnet 5で変わっています。詳細はSonnet 5とSonnet 4.6の比較を参照してください。

Sonnet 5はコーディングに十分ですか？

多くのClaude Codeでのエージェント型コーディングでは、Sonnet 5が強力なデフォルトになります。Anthropicの発売時ベンチマークでは、SWE-bench ProやTerminal-Benchのようなツール使用タスクで、Opus 4.8に約1〜3ポイント差まで近づいています。

ただし、純粋な推論が難しい問題や、長期的な自律作業ではOpus 4.8への切り替えを検討してください。

Claude CodeでSonnet 5を無料で利用できますか？

Sonnet 5は無料版とPro版のClaudeアプリのデフォルトモデルであり、Claude Codeで利用できます。ただし、無料利用にはレート制限や使用制限があります。詳細はClaude Sonnet 5無料ガイドを参照してください。

新しいトークナイザーはClaude Codeセッションにどう影響しますか？

同じテキストでも、Sonnet 4.6と比較して約30%多くのトークンが生成されます。API形式が変わるわけではないため、処理が直接壊れるわけではありません。

ただし、次の影響があります。

  • 100万トークンのコンテキストウィンドウに入るテキスト量が減る
  • 同じ量のコードやドキュメントでもコストが増える可能性がある
  • 既存のトークン見積もりを再計算する必要がある

Sonnet 5を本格的に使う場合は、実際のワークロードでトークン数を再カウントしてから予算化してください。

Top comments (0)