DEV Community

Cover image for カーソルでクロードソネット5を使う方法
Akira
Akira

Posted on • Originally published at apidog.com

カーソルでクロードソネット5を使う方法

Claude Sonnet 5は2026年6月30日にリリースされ、Cursorでのエージェント型コーディングに適したモデルです。Anthropicは、Sonnet 5をこれまでのSonnetモデルで最もエージェント性が高く、ツール使用性能はOpus 4.8に近い一方で低価格だと説明しています。Cursorでは、モデルがファイルを読み取り、コードを編集し、コマンドを実行しながら作業するため、この特性が重要です。モデル概要はClaude Sonnet 5とは何か、リリース詳細はAnthropicの公式発表を参照してください。

今すぐApidogを試す

Apidogは、CursorとSonnet 5でAPIを実装した後に、リクエスト送信、保存、モック、エンドポイントテストを行うための実行環境として使えます。

Sonnet 5がCursorのデフォルト候補になる理由

Cursorのエージェントは、次のような小さなツール駆動のステップを繰り返します。

  • ファイルを開く
  • コードベースを検索する
  • 複数ファイルに編集を適用する
  • ターミナルコマンドを実行する
  • テスト結果を見て再修正する

これはSonnet 5が得意とする作業パターンです。

Claude Sonnet 5 benchmark image

Anthropicのローンチベンチマークでは、Sonnet 5はエージェントタスクでOpus 4.8に近い結果を示しています。たとえば、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% -
OSWorld-Verified 81.2% 83.4% -

これらはAnthropicが報告した数値であり、独自テストではありません。詳細はClaude Sonnet 5のベンチマークを参照してください。

実務上のポイントはシンプルです。

  • ツール使用を含む作業では、Sonnet 5はOpus 4.8にかなり近い
  • 純粋な推論では、Opus 4.8のほうが優位
  • Cursorではほとんどの作業がツール使用を伴う
  • そのため、Sonnet 5は日常的な開発のデフォルトとして使いやすい

価格面でもSonnet 5は扱いやすいモデルです。標準料金は入力100万トークンあたり3ドル、出力100万トークンあたり15ドルです。Anthropicは2026年8月31日まで、入力100万トークンあたり2ドル、出力100万トークンあたり10ドルの導入料金を設定しています。Opus 4.8は入力100万トークンあたり5ドル、出力100万トークンあたり25ドルです。

長いエージェントセッションでは、モデル単価の差がそのままコスト差になります。

CursorでSonnet 5を使う方法

CursorでSonnet 5を使う方法は主に2つあります。

  1. Cursorの内蔵モデルピッカーから選択する
  2. 独自のAnthropic APIキーを設定する

CursorのバージョンによってUIの表記は変わるため、以下は具体的なメニュー名ではなく設定フローとして見てください。

方法1:Cursorの内蔵モデルピッカーを使う

CursorプランにClaudeモデルが含まれている場合は、この方法が最も簡単です。

  1. Cursorを開く
  2. チャット、Composer、または設定画面からモデルセレクターを開く
  3. モデル一覧でClaude Sonnet 5を探す
  4. 選択する
  5. チャット、編集、エージェント実行でSonnet 5を使う

Sonnet 5が表示されない場合は、まずCursorを最新バージョンに更新してください。新しいモデルが特定のCursorビルドに反映されるまで時間がかかる場合があります。

Cursorの初期設定から確認したい場合は、Cursorセットアップガイドを参照してください。

方法2:独自のAnthropic APIキーを使う

BYOK(bring-your-own-key)は、次のような場合に便利です。

  • Anthropicアカウントで直接請求を管理したい
  • アカウントに紐付いた制限を使いたい
  • Cursorプランに含まれていないモデルを使いたい

設定手順は次のとおりです。

  1. Claude Consoleを開く
  2. 組織のAPIキー画面でAnthropic APIキーを作成する
  3. Cursorの設定を開く
  4. モデルまたはAPIキー設定セクションを開く
  5. Anthropicプロバイダー欄にAPIキーを貼り付ける
  6. 保存する
  7. アクティブモデルとしてClaude Sonnet 5を選択する

Anthropicが公開しているモデルIDは次の文字列です。

claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

通常、このIDをCursorのUIに直接入力する必要はありません。ただし、Anthropic APIに対してスクリプトを書く場合は必要になります。リクエスト形式、モデルID、レスポンス形式はClaude Sonnet 5 APIガイドを参照してください。

APIキーはコードベースに入れないでください。環境変数やOSキーチェーンに保存し、Gitにコミットしない構成にします。

例:

export ANTHROPIC_API_KEY="your_api_key_here"
Enter fullscreen mode Exit fullscreen mode

.envを使う場合も、必ず.gitignoreに含めます。

.env
Enter fullscreen mode Exit fullscreen mode

Sonnet 5で注意すべき挙動変更

Sonnet 5はAPIレベルではSonnet 4.6のドロップイン代替として扱えます。ただし、Cursorで使う場合でも、次の変更は理解しておくと安全です。

適応的思考がデフォルトで有効

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

Cursorでは、これは次のような挙動につながります。

  • 複雑な変更の前に計画を立てやすい
  • 複数ファイル編集の整合性を取りやすい
  • 難しいプロンプトでは応答が少し遅くなる場合がある
  • 思考トークンが出力に含まれ、コストが上がる場合がある

実装タスクでは、この挙動は基本的に有利です。ただし、短い単発質問や小さな編集を大量に行う場合は、トークン使用量を確認してください。

新しいトークナイザーでトークン数が増える

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

重要なのは次の点です。

  • リクエストとレスポンスの形式は同じ
  • 既存の呼び出しが形式面で壊れるわけではない
  • ただし、トークンで測るコストやコンテキスト量は変わる
  • 100万トークンのコンテキストに入る実テキスト量はやや少なくなる
  • トークン単価が同じでも、同等リクエストの総コストは増える可能性がある

Cursorの利用コストを管理している場合は、Sonnet 4.6の数値を流用せず、Sonnet 5で再計測してください。

API直叩きでは一部パラメータに注意

Anthropic APIに対して直接スクリプトを書く場合、次の制約があります。

  • budget_tokensを使った手動の拡張思考は400エラーになる
  • temperaturetop_ptop_kをデフォルト以外にすると400エラーになる

挙動を制御したい場合は、サンプリングパラメータではなくプロンプトで調整します。

Cursorは内部のモデル呼び出しでこれらを処理するため、通常のCursor利用では意識する必要はありません。Anthropic APIを直接扱う場合のみ注意してください。

CursorのエージェントモードでSonnet 5を使う

Sonnet 5をCursorで使うなら、エージェントモードが最も効果を発揮します。モデルがプロジェクトを読み込み、変更を計画し、複数ファイルを編集し、ターミナルコマンドを実行し、結果を検証できます。

実用的なプロンプトの書き方

エージェントモードでは、手順を細かく指定するよりも、目的と制約を明確に伝えます。

悪い例:

orders.jsを開いて、関数を追加して、app.jsを編集して、テストを書いてください。
Enter fullscreen mode Exit fullscreen mode

良い例:

ExpressアプリにPOST /ordersエンドポイントを追加してください。

要件:
- customerIdとitemsをJSON bodyで受け取る
- customerIdがない、またはitemsが空の場合は400を返す
- 成功時は201で作成済み注文を返す
- 既存のルーティング構成に合わせる
- 関連するテストも追加する

まず変更計画を提示してから編集してください。
Enter fullscreen mode Exit fullscreen mode

エージェント実行時のチェックリスト

Sonnet 5に作業させるときは、次の流れにすると差分を管理しやすくなります。

  1. 作りたい結果を説明する
  2. 対象ディレクトリや対象ファイルを指定する
  3. 先に計画を出させる
  4. 計画がずれていないか確認する
  5. 編集を実行させる
  6. テストコマンドを実行させる
  7. すべての差分を自分で確認する
  8. 必要に応じて小さく追加修正させる

Sonnet 5はエージェント的なコーディングに強いモデルですが、マージ判断の責任は開発者側にあります。大きすぎるタスクを一度に渡さず、差分をレビューできる単位に分けるのが実用的です。

実装例:APIを作成してテストする

例として、CursorのSonnet 5に、注文作成用のExpressルートをスキャフォールドさせるとします。

// routes/orders.js
const express = require('express');
const router = express.Router();

router.post('/orders', (req, res) => {
  const { customerId, items } = req.body;

  if (!customerId || !Array.isArray(items) || items.length === 0) {
    return res.status(400).json({ error: 'customerId and items are required' });
  }

  const order = {
    id: `order_${Date.now()}`,
    customerId,
    items,
    status: 'created',
  };

  return res.status(201).json(order);
});

module.exports = router;
Enter fullscreen mode Exit fullscreen mode

CursorとSonnet 5は、このルートの生成、アプリへの接続、テストドラフトの作成まで支援できます。ただし、生成されたコードは実際のHTTPリクエストで検証する必要があります。そこでApidogを使います。

Apidog API testing image

Apidogでは、次の流れで確認できます。

  1. POST /ordersリクエストを作成する
  2. JSON bodyを指定する
  3. 201レスポンスが返ることを確認する
  4. レスポンス形式を確認する
  5. リクエストをコレクションに保存する
  6. 環境変数にベースURLやキーを保存する
  7. 自動アサーションを追加する
  8. 必要に応じてCIでテストスイートを実行する

リクエスト例:

{
  "customerId": "cus_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

期待するレスポンス例:

{
  "id": "order_1720000000000",
  "customerId": "cus_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ],
  "status": "created"
}
Enter fullscreen mode Exit fullscreen mode

自動アサーションでは、たとえば次のような条件を確認します。

  • ステータスコードが201
  • idが存在する
  • statuscreated
  • customerIdがリクエスト値と一致する
  • itemsが配列である

Apidogを使うと、CursorとSonnet 5で素早く作ったAPIを、再現可能なリクエストとテストとして残せます。Postmanから移行する場合は、PostmanなしでのAPIテストのウォークスルーも参考になります。Apidogをダウンロードして、手元のエンドポイントで試してください。

費用と使用量の見方

Cursorは独自の課金、制限、モデルアクセスを管理しています。詳細は時間とともに変わるため、現在のCursorプランを直接確認してください。

ただし、モデル選択では次の原則が使えます。

  • 日常的な実装やリファクタリングではSonnet 5をデフォルトにする
  • 難しい設計判断や複雑なデバッグではOpus 4.8を検討する
  • 長いエージェントセッションではトークン使用量を確認する
  • Sonnet 5ではSonnet 4.6よりトークン数が増える前提で見積もる
  • BYOKではAnthropic側の実使用量ベースで請求される

特に、次のようなタスクはコストが増えやすいです。

  • 大量のファイルをコンテキストに入れる
  • 長いログを丸ごと貼り付ける
  • 大きな差分を一度に修正させる
  • テスト失敗後の再実行ループを何度も回す

コストを抑えるには、タスクを小さく分割します。

src/orders配下だけを対象に、POST /ordersのバリデーション修正を行ってください。
まず関連ファイルを確認し、変更計画を出してください。
Enter fullscreen mode Exit fullscreen mode

このようにスコープを指定すると、読み込むファイルや編集範囲を抑えやすくなります。

Cursorでのモデル選択を広く比較したい場合は、最適なCursorモデルも参照してください。

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

Sonnet 5は、ほとんどのCursor作業をカバーできます。次のようなタスクでは、Opus 4.8への切り替えを検討してください。

  • アーキテクチャ上の難しい意思決定
  • 原因が見えにくい複雑なバグの調査
  • 段階的な推論が必要なデバッグ
  • コストより品質を優先する長時間の自律実行
  • ツール使用よりも純粋な推論能力が重要な作業

報告ベンチマークでは、ツールなしの純粋な推論でOpus 4.8がSonnet 5を約6ポイント上回っています。最も難しいタスクでは、この差に対して追加コストを払う価値があります。

一方で、次のような通常の開発作業ではSonnet 5を維持するのが現実的です。

  • 機能追加
  • 小〜中規模のリファクタリング
  • テスト作成
  • テスト失敗の修正
  • APIルートの実装
  • 型エラーの修正
  • ドキュメント更新

基本方針は、Sonnet 5をデフォルトにし、タスクが実際に詰まったときだけOpus 4.8に切り替えることです。

よくある質問

Claude Sonnet 5はCursorで利用できますか?

CursorはAnthropicのClaudeモデルをサポートしています。CursorのビルドがSonnet 5をサポートしていれば、モデルピッカーに表示されるはずです。表示されない場合は、Cursorを最新バージョンに更新してください。Anthropic APIキーを使ってBYOKで追加することもできます。

CursorでSonnet 5を使うには独自のAPIキーが必要ですか?

必ずしも必要ではありません。CursorプランにClaudeモデルが含まれている場合は、キーなしでSonnet 5を選択できます。Anthropicアカウントで請求したい場合や、制限を直接管理したい場合はBYOKを使います。キーの作成方法はClaude Sonnet 5 APIガイドを参照してください。

CursorでのコーディングにはSonnet 5とOpus 4.8のどちらが良いですか?

ほとんどのCursor作業では、Sonnet 5のほうがコスト効率に優れます。Opus 4.8に近いエージェントコーディング性能を低価格で使えるためです。最も難しい推論タスクではOpus 4.8を使ってください。詳細はSonnet 5対Opus 4.8の比較を参照してください。

なぜSonnet 5はSonnet 4.6より多くのトークンを使うように見えるのですか?

Sonnet 5は新しいトークナイザーを使っており、同じテキストでも約30%多くのトークンを生成します。トークンあたりの価格が同じでも、同等リクエストの総コストは高くなる可能性があります。古い見積もりを流用せず、実際のワークロードで測定してください。

Sonnet 5をCursorで無料で使えますか?

それはCursorのプランによります。Sonnet 5は無料のClaudeウェブおよびアプリプランのデフォルトモデルですが、Cursorの提供条件とは別です。Cursorの現在のプラン詳細で、Sonnet 5が含まれているか確認してください。

Top comments (0)