Claude CodeでSonnet 5.5を使うには？モデル・effort・権限の確認

Claude CodeでSonnet 5.5を明示的に選ぶには、そのIDを受け付ける提供元で、新規セッションにclaude --model claude-sonnet-5-5、既存セッションに/model claude-sonnet-5-5を使います。まずクライアント版とアカウントのモデル権限を確認してください。現在のAnthropic資料ではClaude Code v2.1.284以降が必要です。

クライアントがモデルを認識すること、提供元がモデルを提供していること、アカウントに利用権限があることは別です。2026年9月29日にClaude Codeのモデル設定資料で手順を確認しました。すべての月額契約や第三者エンドポイントで利用できると確認したものではありません。

バージョンを確認してモデルを選ぶ

ターミナルで実行します。

claude --version
claude update
claude --model claude-sonnet-5-5 --effort medium

claude updateはインストール済みクライアントを更新します。組織が管理している場合は、そのソフトウェア管理手順に従ってください。既存の対話セッションでは次を使います。

/model claude-sonnet-5-5
/status

コマンドが成功したと思い込まず、表示されたモデルと提供元を確認します。生成された回答の自己紹介は、実際に処理したモデルの証拠にはなりません。クライアント状態とレスポンスのメタデータを確認しましょう。

短い別名sonnetは便利ですが、対応先は提供元とクライアント版によります。現行資料ではAnthropic APIでSonnet 5.5を指しますが、一部クラウド提供元の別名は古いSonnetを指しています。完全なモデル名で意図を明確にしても、提供元が対応するIDとアクセス経路を使う必要があります。

既定値を変えるだけでは不十分な理由

Claude Codeの既定モデルが最新Sonnetとは限りません。現在の資料では、複数のアカウント・提供元区分でOpus 5.5が既定です。Sonnetは意図して選択します。組織がモデルを制限していれば、公開ガイドとは異なる選択肢になる場合があります。

ANTHROPIC_DEFAULT_SONNET_MODELなどの環境変数も別名の対応先を変えます。編集前に、ユーザー、プロジェクト、管理対象の設定を確認してください。実験を戻せるよう元の値を残し、1セッションを直すためにチーム共通の提供元設定を上書きしないようにします。

再現可能なテストでは明示的に選び、その後で永続的な既定値にするかを判断します。1回の試験のために、全リポジトリや全エージェント定義を変更する必要はありません。

作業に合わせてeffortを選ぶ

Sonnet 5.5 APIの既定effortはhighです。一方、Claude Codeのモデル設定資料ではSonnet 5.5の既定をmediumとしています。入口が違うため、同じ説明として扱えません。

要件が明確なコード変更では、資料に沿ってmediumから試せます。作業と結果に理由がある場合に上げましょう。対話クライアントの/effortか起動時の--effortを、アカウントの制限内で使います。管理設定の上限により、要求より低い設定が実際に使われる場合があるため、確認できる適用設定を記録してください。

Effortガイドでは、高いラベルが良い結果を保証しない理由を説明しています。隔離したブランチ、明確な合格条件、確認できる差分から始めましょう。ツール実行には権限が必要であり、マージ前に変更を確認する必要もあります。

月額契約のアクセスとAPI課金を分ける

Claudeの契約ログインとAPIキーは異なるアクセス経路です。「組織がClaude Codeの契約アクセスを無効にした」というメッセージは、アカウント方針によるブロックであり、Sonnetの障害を証明するものではありません。管理者に認められたアクセス経路を確認し、管理制限を回避しようとしないでください。

本記事の準備中、ローカルのClaude Code v2.1.281はその組織アクセスメッセージを返し、Sonnetのタスクを実行しませんでした。資料の最低版も下回っていました。したがって、この試行からモデルのテスト成功、所要時間、費用測定は主張していません。上のコマンド例は、文書に照らして確認した手順です。

承認済みのAPI経路がある場合、そのリクエストはAPI課金になります。月額契約も持っているというだけでは無料になりません。試す前に正確なエンドポイント、モデル、アカウント、現行料金を確認しましょう。提供元単価の計算はSonnet API料金ガイドで説明しています。

実際の症状を切り分ける

404だけで全体障害と判断したり、429だけで契約解約と判断したりしないでください。秘密情報を除いたエラー本文、時刻、クライアント版を保存します。問い合わせにはトークン、環境変数の全出力、非公開リポジトリ情報を添付しないでください。

ネイティブAPIの変更はSonnet 5.5移行チェックリスト、旧モデルから切り替える判断はSonnet 5と5.5の比較を参照できます。