claude-api スキルのデフォルトモデルを Opus 4.8 へ移行

claude-api スキル全体のデフォルトモデルが claude-opus-4-7 から claude-opus-4-8 へ更新され、移行ガイド・モデルリファレンス・全言語のコード例が一括で書き換えられた。Opus 4.8 は Opus 4.7 との API 互換性を維持しつつ能力と挙動が改善されており、既存コードへの影響を最小限に抑えながら最新世代のモデルへ移行できる。

背景

claude-opus-4-8 が新たに利用可能になり、Anthropic のスキルドキュメントが参照する「最新の推奨 Opus」が更新された。移行ガイド (shared/model-migration.md) に新設された「Migrating to Opus 4.8」セクションによると、4.7 → 4.8 は 新たな破壊的変更を含まない「モデル ID の差し替え＋プロンプト再チューニング」に位置づけられている。

一方で、Opus 4.6 以前からの移行は従来通り段階的なアプローチが必要だ。shared/model-migration.md の Destination Models テーブルが更新され、Opus 4.5 以下からの移行先も claude-opus-4-7 から claude-opus-4-8 に差し替えられている。移行ガイドには「Opus 4.5 → 4.8 は 4.6、4.7、4.8 の各セクションを順に適用する」と明記されており、レイヤー型のマイグレーションパスが維持されている。

また、shared/managed-agents-multiagent.md に残存していた未展開のプレースホルダー {{OPUS_ID}} が claude-opus-4-8 に修正されており、ドキュメントの品質向上も兼ねた変更となっている。

技術的な変更

本 PR の変更は大きく 3 つのカテゴリに分類できる：移行ガイドの新規セクション追加、モデルリファレンスの更新、そして全言語コード例のモデル ID 差し替えだ。

移行ガイドの新規セクション（shared/model-migration.md）

shared/model-migration.md に「Migrating to Opus 4.8」と「Opus 4.8 Migration Checklist」の 2 セクションが追加された。チェックリストには以下の項目が含まれている：

• モデル ID の差し替え（claude-opus-4-7 → claude-opus-4-8）
• プロンプト再チューニング（search-first、サブエージェント・メモリ・ツールのトリガー、ナレーション無効化デフォルト、自律性、thinking-off 時の挙動）
• ミッドセッション・システムプロンプトのサポート確認
• ケイパビリティ改善の活用

Destination Models テーブルも刷新されており、Opus 4.7 からの移行先が claude-opus-4-8（API 互換）、Opus 4.6 以下からの移行先も claude-opus-4-8（段階的移行）に統一された。

モデルリファレンスの更新（shared/models.md、SKILL.md）

shared/models.md では、Current Models テーブルに claude-opus-4-8（1M コンテキスト、128K 出力）が追加され、Opus 4.7 が「previous-generation」に再定義された。モデル説明文も刷新されており、Opus 4.8 は「highly autonomous、state-of-the-art on long-horizon agentic work、clearer and warmer writing」と記述されている。

SKILL.md では推奨モデルの記述が更新され、Thinking & Effort セクションの見出しが Opus 4.7 — Adaptive thinking only から Opus 4.8 / 4.7 — Adaptive thinking only に変更された。また、thinking を無効にした場合に Opus 4.8 が visible response に長い推論を書き込む可能性についての注記が追加されている。

変更前:

**Opus 4.7 — Adaptive thinking only:** Use `thinking: {type: "adaptive"}`. `thinking: {type: "enabled", budget_tokens: N}` returns a 400 on Opus 4.7 — adaptive is the only on-mode.

変更後:

**Opus 4.8 / 4.7 — Adaptive thinking only:** Use `thinking: {type: "adaptive"}`. `thinking: {type: "enabled", budget_tokens: N}` returns a 400 — adaptive is the only on-mode. Opus 4.8 keeps the same request surface as 4.7 (no new breaking changes) — see `shared/model-migration.md` → Migrating to Opus 4.8 for the behavioral re-tuning, and → Migrating to Opus 4.7 for the full breaking-change list when coming from 4.6 or earlier. Note: with `thinking` disabled, Opus 4.8 may write longer reasoning into the visible response — leave adaptive thinking on, or add a final-answer-only instruction.

全言語コード例のモデル ID 差し替え

Python、TypeScript、Ruby、PHP、Java、Go、curl の各言語ガイドおよびマネージドエージェントの README にわたり、すべての claude-opus-4-7 が claude-opus-4-8 に置き換えられた。対象ファイルは以下の通り：

• python/claude-api/README.md、batches.md、files-api.md、streaming.md、tool-use.md
• python/managed-agents/README.md
• typescript/claude-api/README.md、batches.md
• ruby/claude-api.md、ruby/managed-agents/README.md
• php/claude-api.md、php/managed-agents/README.md
• java/claude-api.md、java/managed-agents/README.md
• go/managed-agents/README.md
• curl/examples.md、curl/managed-agents.md

shared/prompt-caching.md のキャッシュ最小トークン数テーブルにも Opus 4.8 が追加されており（4096 トークン）、shared/error-codes.md のエラー例示も claude-opus-4-8 に統一された。

ツール定義のベストプラクティス更新（shared/tool-use-concepts.md）

ツール定義のベストプラクティスが強化され、ツールの description にトリガー条件を明示的に記述することが推奨されるようになった。

変更前:

- Write detailed descriptions — Claude uses these to decide when to use the tool

変更後:

- Write detailed descriptions — Claude uses these to decide when to use the tool. Be **prescriptive about *when* to call it**, not just what it does (e.g. "Call this when the user asks about current prices or recent events"). On recent Opus models, which reach for tools more conservatively, trigger conditions in the description give measurable lift in should-call rate.

この変更は Opus 4.8 移行チェックリストの「サブエージェント・メモリ・ツールのトリガー」項目と対応しており、新モデルの挙動変化に合わせた実践的なガイダンスとなっている。

設計判断

API 互換性を最優先にした段階的リリース戦略 が本 PR の設計思想の核心だ。Opus 4.8 は Opus 4.7 と同一のリクエストサーフェス（adaptive thinking のみ、sampling パラメータ除去）を維持することで、既存の 4.7 向けコードを無修正で動作させられる。ドキュメントもこの特性を強調しており、「4.7 → 4.8 は破壊的変更なし」と明言している。

モデルリファレンスの更新では、廃止予定モデル（claude-opus-4-20250514）の推奨移行先も claude-opus-4-7 から claude-opus-4-8 に差し替えられた。これは「常に最新の推奨 Opus を指す」という一貫したドキュメント方針の表れであり、利用者が参照するたびに最新のガイダンスを得られるよう設計されている。

ツール定義の改善（トリガー条件の明示）が Opus 4.8 の移行チェックリストと同一 PR に含まれている点も注目に値する。新モデルの「ツールをより保守的に使う」という挙動変化に対し、ドキュメントとコード例の両面でプロアクティブに対応するアプローチを採っている。

まとめ

本 PR は API 互換性を保ったまま最新世代モデルへ移行するための「スキルドキュメント全体の一括更新」であり、移行ガイド・モデルリファレンス・全言語コード例を同時に更新することでドキュメントの一貫性を担保している。Opus 4.8 の「破壊的変更なし」という特性を活かし、既存ユーザーが最小限の作業で最新モデルへ移行できる導線を整備した変更といえる。