Claude CodeとOpus 4.7：完全なセットアップと使用ガイド

クロード・オーパス4.7は、スターモデルとなった。 プログラミング、エージェント、集中的な専門作業のための人間エコシステムから。Opus 4.6のリリースからわずか数か月後に登場したが、単純なパッチではない。 これは、新しいトークナイザー、xhighの労力レベル、指示の解釈方法の変更、そしてClaude Codeのビジョンとワークフローの大幅な改善を導入するものです。もしあなたがすでに快適に感じていたなら 作品4.6バージョン4.7では、より高度な思考能力を発揮するようになり、また、うまく手なずけないとトークンを消費してしまうことも分かります。

このガイドの目的は、あなたが Claude Code + Opus 4.7 の完全な設定マニュアル適切な作業量の選び方、タスク予算によるコスト管理方法、プロンプトを壊さずに4.6から移行する方法、CLAUDE.md、settings.json、スキル、フックを使った一貫性のあるシステム構築方法、そしてSonnetとHaikuのどちらを使い続けるのが最適か。これらすべてをスペイン語で解説。ドル建てで請求するものの、限られた予算でインフラ費用を賄っているチーム向けです。

Claude Opus 4.7は4.6と比べてどのような利点がありますか？

まず明確にしておきたいのは、 Opus 4.7は価格やコンテキストウィンドウを変更しません1回のやり取りにつき最大100万トークンを獲得でき、コストは4.6と同じです。 （入庫時5ドル/トン、出庫時25ドル/トン）長文でも追加料金はかかりません。違いは、トークンの使用方法と、開発者として得られる制御権限にあります。

プログラミングベンチマークにおいて、Anthropicは次のように報告している。 Opus 4.7は、より多くの現実世界の課題を解決します。 バージョン4.6よりも、特にSWE-Benchテストや93個のコーディングタスクからなる内部スイートにおいて、パフォーマンスが向上しています。実際には、大規模なリファクタリング、珍しいバグのデバッグ、アーキテクチャ上の意思決定などを実行する際に、再試行回数が減少します。また、推論能力にも顕著な改善が見られます。より優れた計画性、単純なミスの減少、そして長時間のエージェントフローにおける信頼性の向上を実現しています。

もう一つの重要な変更点は 最大解像度約3,75メガピクセル、長辺2.576ピクセルで視覚が向上これにより、スクリーンショット、技術図面、データベーススキーマ、スキャンされたPDFの認識精度が3倍になります。Vision APIをバージョン4.6で既に使用していた場合は、ディテールを損なうことなく、より大きなスクリーンショットを入力できるようになりました（ただし、解像度が高くなると入力トークンも増えることに注意してください）。

さらに、Opus 4.7は 同じテキストに対してより多くのトークンをカウントする新しいトークナイザーコンテンツによっては、トークン数が4.6倍から1,0倍～1,35倍になる場合があります。コード、JSON、およびラテン文字以外の文字は、コストを最も大きく増加させる要因です。これは、100万トークンあたりの価格が同じであっても、テキストがより多くの単位に分割されると、プロンプトと作業量を最適化しない限り、同じ作業量に対してより多くの費用がかかるため重要です。

最後に、指示の解釈は はるかに文字通りバージョン4.6では、ある程度の柔軟性をもって不足部分を補っていましたが（「短い要約」と入力すると、妥当な150語程度の文章が生成されました）、バージョン4.7ではルールを厳密に守る傾向があり（長さを指定しない限り、最低限の段落が生成されます）、これはバージョン4.6用に既に調整済みのプロンプトに直接的な影響を与えます。

Opus 4.7における努力レベル：低、高、超高、最大

バージョン4.7では、考え方に大きな変化がもたらされます。 推論は適応的になる以前のように「思考トークン」の固定予算を調整するのではなく、タスクの複雑さと設定した労力レベルに基づいて、モデルがどれだけ考えるかを決定します。

Opus 4.7で利用可能なレベルは以下のとおりです。 低、中、高、超高、最大鍵となるのは新しいxhighです。これはhighとmaxの中間に位置し、maxのような法外なコストをかけずに、複雑なプログラミングや長期エージェント向けに設計されています。Claude CodeのOpus 4.7では、xhighがデフォルトの作業レベルとして採用されています。これは、Anthropicがhighではエージェント開発ワークフローにやや不十分であると判断したためです。

範囲をまとめると、典型的な動作は次のようになります。 低/中 レイテンシーとコスト（サポート、抽出、小規模な変換）を優先します。 高い あなたは、コーディング、文書分析、および定期的なレビューのタスクのほとんどを担当します。 xhigh あなたは、複数のプロジェクトのリファクタリング、アーキテクチャ設計、デバッグの微調整を目指しています。 最大 それは、デモンストレーション、正式なテスト、またはセキュリティ監査など、あらゆる論理的推論を徹底的に検証したい場合に利用するものであり、たとえ時間がかかったり費用がかさんだりしても構わない。

Claude Code CLIでは その場の勢いで努力を怠る コマンドを使用する /effortインタラクティブセレクターでレベルを選択するか、直接スキップします /effort xhigh例えば、APIレベルでは、これは適応思考設定フィールドで制御されます。特定のルートでより軽量なアプローチを強制する必要がある場合は、特定のスクリプトまたはサブエージェントに対して設定値を「高」に下げることができます。

重要な詳細が 1 つあります。 最大レベルはセッション間で保持されませんこれは、現在のセッション内の特定のタスクに役立ちます。Claude Code を再度開くと、前回設定した作業量 (通常は xhigh) が継続されます。これにより、誤って何時間もトークンを使い果たしてしまい、最大トークン数に達してしまうことを防ぎます。

Claude Code のタスク予算、自動モード、および /ultrareview

Opus 4.7のリリースに伴い、Claude Codeにも数々の強力な改良が加えられました。CLIを日常的に使用している方にとって、特に注目すべき3つの機能は以下のとおりです。 タスク予算、よりアクセスしやすい自動モード、および /ultrareview コマンド 詳細なレビューについては、こちらをご覧ください。

その タスク予算 これにより、Claude Code セッションのトークン制限を設定できます。これは、モデルが自律エージェントとして動作し、読み取り、編集、テスト、ツール呼び出しを連鎖させる場合に非常に重要です。次のような方法で設定できます。 /config task_budget 50000警官が制限速度に近づくと、停車して走行を続けるか停止するかを尋ねます。これは、ほんの少しの時間で済むと思われたことが、月々の予算の半分を食いつぶしてしまうのを防ぐための安全対策です。

El オートモード 実際には、これは古いものに代わる賢明な選択肢である --dangerously-skip-permissions— は、Opus 4.7 と組み合わせることで Max ユーザーにも利用可能になりました。これは、個別の分類器 (Sonnet 4.6) と連携して動作し、各アクション (bash、MCP、編集) をレビューして、意図に合致しているか、安全であるかを確認します。モデルを既に信頼しており、頻繁な確認なしに「処理を実行」させたいタスクには、このモードが非常に役立ちます。

もう一つの注目作品は /ウルトラレビューこれは、構造化されたプロトコルを使用して詳細なコードレビューを実行するスラッシュコマンドです。非常に高い負荷をかけてモデルを実行し、アーキテクチャ、ロジック、セキュリティ、パフォーマンス、保守性を検証し、フラグが付けられたファイルと推奨事項を含む整理されたレポートを返します。ProプランとMaxプランには、サイクルごとに数回の無料実行が含まれています。それ以降は、他のOpus 4.7セッションと同様に、トークンに基づいて課金されます。

権限の混乱をさらに軽減するために、Anthropic はスキルタイプをリリースしました 「許可を求めるプロンプトを減らす」 セッション履歴をスキャンし、常に承認している繰り返し実行中のbash/MCPコマンドを検出し、settings.jsonの許可リストに追加することを提案します。「これ、実行してもいいですか？」と頻繁に尋ねる必要がなくなり、物事を複雑にすることなく、よりスムーズなワークフローを実現できる、洗練された方法です。

新しいトークナイザー：コストへの実際の影響とその測定方法

財布にとってあまり目立たないが、最も危険な変化の1つは Opus 4.7からトークナイザーを更新しましたバージョン4.6で使用していたプロンプトと同じものでも、コンテンツの種類に応じて、生成されるトークン数が0%から35%増加します。英語の散文ではこの変化はほとんど無視できる程度ですが、ソースコード、JSON、構造化データ、および一部の非ラテン語では顕著な変化が見られます。

請求に関して言えば、これはつまり 以前、Opusのみを使用して4.6で1.000ドル/月を費やしていた場合バージョン4.7では、製品に何も変更を加えることなく、トークンの再生成だけで1.000ドルから1.350ドルの収益が見込めます。さらに、このモデルはより高度な思考（高度な処理能力、適応的な推論）を行うため、負荷の高いワークフローでは収益がさらに増加する可能性があります。

何も知らずに始めるのを避けるために、Anthropic はトークンカウントエンドポイントを公開しています。 実際のプロンプトを4.7トークナイザーに通しますPython SDK から呼び出すことができます client.messages.count_tokens と model="claude-opus-4-7" そして、あなたのプロダクションプロンプトに対するエントリートークンの正確な数を確認してください。それを4.6の場合の同じ数と比較すれば、理論上の乗数ではなく、実際の乗数がわかります。

影響が検知された後は、緩和策として以下の3つの側面からアプローチする。 不要な労力を削減し、生産量を制限し、単純な作業はより安価なモデルに任せる。モデルに対して、簡潔に応答するよう明示的に指示したり（「追加の説明なしに、最大150語で応答する」）、ルーチン呼び出しにおけるmax_tokensを削減したり、割引バッチタスクに対してリアルタイムではなく、長い要約を生成したりすることができます。

プロンプトキャッシュとバッチAPI（応答時間が24時間以内のトークンは半額）を組み合わせれば、トークナイザーの追加コストのかなりの部分を相殺できます。重要なのは、あらゆる場面でOpus 4.7をxhighのインタラクティブモードで使用することを避けることです。なぜなら、それが最大のコスト増加要因となるからです。

Opus 4.6から4.7への移行を問題なく行う

4.6から4.7へのアップグレードは、単にモデルIDを変更するだけではありません。 従うべき5つのステップ 既に運用環境にある場合は、識別子を更新し、プロンプトを再検証し、トークンを測定し、作業量を調整し、100%稼働させる前に実際のトラフィックでテストしてください。

最初の部分は非常に機械的だ。 コード内を検索して、 claude-opus-4-6 そしてそれらを claude-opus-4-7.py、.ts、.json、.yaml の再帰的な grep は、すべてを返します。エイリアスを使用すると、 opus Claude Codeでは、多くのプランでエイリアスが既に新しいバージョンを指しているため、切り替えはさらに簡単になりますが、バックエンドインフラストラクチャについては、明示的なIDを設定することをお勧めします。

次に、重要なプロンプトを確認します。バージョン4.7では指示に忠実に従うため、 曖昧な指示は結果を低下させる可能性がある典型的な例として、「この文書を要約してください。簡潔に。」という指示があった場合、4.6ではおそらく150語程度の要約と適切な箇条書きが生成されるでしょう。一方、4.7では40～50語程度しか生成されないかもしれません。解決策は、指示を明確にすることです（「3つの重要なポイントを盛り込んだ100～150語の要約を作成してください。」）。

3番目のステップは count_tokensを使用したベンチマークトークン使用状況 代表的なプロンプト、特に処理量の多いプロンプト（サポートフロー、RAG、評価パイプラインなど）については、パーセンテージ差を計算し、コスト見積もりを調整します。また、トークンの最大出力値を見直し、上限が高すぎる場合は引き下げることをお勧めします。

第四に、 努力を明示的に設定する 呼び出しにおいて。Claude Code は Opus 4.7 に xhigh を既に含んでいますが、4.6 から高労力で移行する場合は、プロジェクト構成または API 呼び出しで高労力を宣言することにより、一部のフローでそのレベルを維持することができます。

ついに、 トラフィックの100%を一度に移行しないでください。5～10%を4.7にリダイレクトし、品質、コスト、レイテンシ、エラーを比較検討し、問題がないと判断できた場合にのみ移行を完了してください。トークナイザーの変更と文字通りの解釈は中期的にはプラスの効果をもたらしますが、短期的にはプロンプトにおける脆弱な前提が露呈する可能性があります。

一貫性を保つために、Claude Code の設定を行います: CLAUDE.md、設定、およびスキル

「クロードは一貫性がない」という苦情のほとんどは、モデルの問題ではなく、 プロジェクトごとに永続的な設定はありません。新しいセッションを開くたびに、厳密なTypeScript、アロー関数、JestではなくVitest、特定のストア規約を使用していることを覚えておかなければならないとしたら、問題はAIにあるのではなく、それを一度宣言できる場所がないということだ。

その場所は リポジトリのルートにあるCLAUDE.mdClaude Code は、このプロジェクトにおけるすべての会話の開始時にこのファイルを自動的に読み込みます。ここに、コードスタック、コーディング規約、推奨パターン、既知のバグ、および環境制約を指定してください。一般的なプログラミング哲学は必要ありません。このモデルにはそのような記述は不要です。

ツール自体にはコマンドが含まれています /init このツールはコードを解析し、初期のCLAUDE.mdファイルを生成します。完璧ではありませんが（当たり前のことが含まれていたり、詳細が省略されていたりすることもあります）、出発点としては役立ちます。そこから先は、このファイルを継続的にメンテナンスすることが重要です。 軽く、プロジェクトの文脈に焦点を当てた長いコードパターンは貼り付けないでください。それらは「スキル」欄に投稿してください。

それから settings.jsonここでは、永続的な権限、Claude から見える環境変数、特定のアクションの前後に必ず実行されるフックを定義します。階層構造はカスケードになっており、グローバルなユーザー設定 (~/.claude/settings.json) とプロジェクト固有の設定 (.claude/settings.json) があります。これらの設定が競合する場合は、より具体的な (プロジェクト固有の) 設定が優先されるため、リポジトリごとに異なるポリシーを適用するのに便利です。

合理的なパターンは ユーザー設定には大まかなオプション（例えば、コードファイルの読み取りやリンターの実行を許可するなど）を残し、プロジェクト内で、許可なしに実行させたくない処理を細かく設定する。 （デプロイスクリプト、マイグレーション、シークレットへのアクセスなど）。リポジトリにsettings.jsonが存在しない場合、グローバルな動作に縛られてしまいますが、これは往々にして緩すぎるか、逆に常に同じことを受け入れることを強いられることになります。

コスト戦略：Opus 4.7、Sonnet 4.6、Haiku 4.5をいつ使うべきか

Opus 4.7は難曲だが、必ずしもそうである必要はない 釘一本一本にハンマーを当ててくださいAnthropic社は、コスト面で様々な可能性を探るためのモデル群を用意しており、Haiku 4.5、Sonnet 4.6、Opus 4.7は、ほぼあらゆるニーズに対応できる。

俳句4.5 これは軽量モデルで、高速かつ非常に低価格です。分類、簡単な抽出、メタデータ生成、簡単な要約、そして特にファイルスキャンや検索を実行するサブエージェントに最適です。リポジトリ、ログ、ドキュメントをスキャンするために多数のサブエージェントを起動するシステムをお持ちの場合、Haikuを追加することでコストを大幅に削減できます。

ソネット4.6 これはバランスの取れた頼れるツールです。中価格帯でありながら、日常的な開発タスク（コードの記述、バグ修正、テスト生成、適切なリファクタリングなど）のほとんどに対応できる十分なインテリジェンスを備えています。さらに、1万トークンのコンテキストと適応思考機能も搭載しているため、Opusに常に頼ることなく大規模なコードベースを扱うことができます。

作品4.7 品質が絶対に譲れない状況、例えばアーキテクチャ上の決定、繊細なデバッグ、セキュリティ分析、エージェントチームの調整、あるいは失敗した場合の損失がトークン数ドル分をはるかに超えるプロジェクトなどに限定して使用すべきです。多くの企業では、タスクの種類に応じてルーティングするのが効果的な戦略となっています。例えば、単純または中程度のタスクはSonnetやHaikuに、複雑なタスクはOpusにルーティングするといった具合です。

リクエストの種類と複雑さを監視するルーティングレイヤーを設定すれば、 40～60％のコスト削減 本当に重要な部分で品質を犠牲にすることなく。実際、Anthropicは、単純な作業をソネットと俳句に分けるだけで、法外な費用を回避できたチームの事例を紹介している。

最終的に、CLAUDE.md、設定、スキル、モデルルーティング、権限、フックを適切に設定すれば、 Opus 4.7は「より大きなモデル」ではなくなり、かなり本格的な開発の副操縦士となる。適切な労力、タスク予算、サンドボックス、および各タスクのモデル選択のバランスを取れば、トークンメーターを常に確認することなく、重い作業を委任できます。バージョン4.6から移行する場合は、エージェントの推論、ビジョン、信頼性の面で大きな進歩が見られます。新規に導入する場合は、バージョン4.7から直接始めるのが賢明ですが、月末に予期せぬ事態が発生しないよう、初日から構成とコストを計画しておきましょう。