Claude Opus 4.7 の破壊的変更と adaptive thinking 実践

# このファイルを .env にコピーして値を入れる

# https://console.anthropic.com/settings/keys
ANTHROPIC_API_KEY=

# opus-4-7-migration-starter

Claude Opus 4.6 / Sonnet 4.6 世代の API 呼び出しコードを **Claude Opus 4.7** に移行するための最小リファレンス集。
[記事本文](https://r43lab.com/blog/claude-opus-4-7-breaking-changes) と対になります。

## 含まれるもの

- `src/before.ts` — Opus 4.6 時代のコード(`temperature` / `budget_tokens` 入り)
- `src/after.ts` — Opus 4.7 向けに書き直した等価コード
- `src/with-task-budgets.ts` — Task Budgets beta(`task-budgets-2026-03-13`)を使う例
- `src/subagent-split.ts` — main は Opus 4.7 xhigh、探索は Haiku 4.5 low、という使い分け例

## Quick start

```bash
bun install
cp .env.example .env   # ANTHROPIC_API_KEY を入れる

# 移行前後の差分を動かして usage を比較
bun run src/before.ts
bun run src/after.ts

# Task Budgets の動作確認
bun run src/with-task-budgets.ts
```

## チェックリスト(Opus 4.6 → 4.7)

- [ ] `temperature` / `top_p` / `top_k` を削除
- [ ] `thinking: { type: "enabled", budget_tokens }` → `thinking: { type: "adaptive" }`
- [ ] 既定 effort が `high` で問題ないか確認、エージェント伴走なら `xhigh` を検討
- [ ] ストリーミング UI は `thinking.display: "summarized"` を明示(何も表示されない問題の対処)
- [ ] fixture や CI テストに `temperature: 0` 等が埋まっていないか grep
- [ ] 最後のメッセージが assistant で終わる prefill 型の会話組み立てを改める

{
  "name": "opus-4-7-migration-starter",
  "private": true,
  "type": "module",
  "scripts": {
    "before": "bun src/before.ts",
    "after": "bun src/after.ts",
    "budgets": "bun src/with-task-budgets.ts",
    "subagent": "bun src/subagent-split.ts"
  },
  "dependencies": {
    "@anthropic-ai/sdk": "^0.90.0"
  },
  "devDependencies": {
    "@types/bun": "^1.3.0",
    "typescript": "^6.0.3"
  }
}

/**
 * after.ts — Opus 4.7 向けに移行した等価コード
 *
 * 変更点:
 *   - model: claude-opus-4-6 → claude-opus-4-7
 *   - temperature / top_p を削除 (4.7 で 400)
 *   - thinking: "enabled" + budget_tokens → "adaptive" (4.7 では budget_tokens 不可)
 *   - output_config.effort で応答のきめ細かさを指定
 *   - 思考内容を UI に流すなら thinking.display: "summarized" を明示
 */
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

async function main() {
  const res = await client.messages.create({
    model: "claude-opus-4-7",
    max_tokens: 8_000,
    thinking: {
      type: "adaptive",
      // UI に思考経過を出したい場合のみ明示 (4.7 のデフォルトは "omitted")
      display: "summarized",
    },
    output_config: {
      // "xhigh" は Opus 4.7 で追加。Claude Code でも採用されている実装向け推奨値。
      effort: "xhigh",
    },
    system: "You are a senior TypeScript reviewer. Reply in Japanese, 300 chars max.",
    messages: [
      { role: "user", content: "次の型定義の是非を教えて: `type User = { id: any; name: string }`" },
    ],
  });

  for (const block of res.content) {
    if (block.type === "text") console.log("[answer]", block.text);
    if (block.type === "thinking") console.log("[thinking]", block.thinking);
  }
  console.log("\nusage:", res.usage);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

/**
 * before.ts — Opus 4.6 / Sonnet 4.6 までの典型的な呼び出し
 *
 * このまま `model` だけ `claude-opus-4-7` に書き換えると、
 * temperature / budget_tokens が 400 で弾かれる。
 * 移行後の姿は src/after.ts を参照。
 */
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

async function main() {
  const res = await client.messages.create({
    model: "claude-opus-4-6",
    max_tokens: 8_000,
    // ↓ これらは Opus 4.7 ではすべて削除対象
    temperature: 0.3,
    top_p: 0.9,
    thinking: { type: "enabled", budget_tokens: 10_000 },
    // ──
    system: "You are a senior TypeScript reviewer. Reply in Japanese, 300 chars max.",
    messages: [
      { role: "user", content: "次の型定義の是非を教えて: `type User = { id: any; name: string }`" },
    ],
  });

  for (const block of res.content) {
    if (block.type === "text") console.log(block.text);
  }
  console.log("\nusage:", res.usage);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

/**
 * subagent-split.ts — main は Opus 4.7 xhigh、探索サブは Haiku 4.5 low
 *
 * 同じ main session に複数モデルの呼び出しが混ざると prompt cache が
 * 割れるため、メインの会話は Opus 4.7 に固定し、並列探索やログ要約は
 * 別 process (= ここでは別呼び出し) で Haiku 4.5 に逃がす。
 */
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

/** 並列に走らせる軽量リサーチ(Haiku 4.5 + low effort) */
async function quickScout(query: string) {
  const res = await client.messages.create({
    model: "claude-haiku-4-5",
    max_tokens: 1_000,
    output_config: { effort: "low" },
    system: "You are a quick scout. Return 1-2 bullets, no preamble.",
    messages: [{ role: "user", content: query }],
  });
  return res.content
    .filter((b) => b.type === "text")
    .map((b) => (b as { text: string }).text)
    .join("\n");
}

/** 本番の判断は Opus 4.7 + xhigh */
async function plan(notes: string[]) {
  const res = await client.messages.create({
    model: "claude-opus-4-7",
    max_tokens: 16_000,
    thinking: { type: "adaptive" },
    output_config: { effort: "xhigh" },
    system:
      "You are the senior engineer. Integrate the scout notes and propose a 1-paragraph plan.",
    messages: [
      {
        role: "user",
        content: `Scout notes:\n${notes.map((n, i) => `#${i + 1}\n${n}`).join("\n\n")}`,
      },
    ],
  });
  return res.content
    .filter((b) => b.type === "text")
    .map((b) => (b as { text: string }).text)
    .join("\n");
}

async function main() {
  // 並列 Haiku で外観情報を集める
  const scouts = await Promise.all([
    quickScout("Cloudflare Workers で OAuth を組むのに向く OSS は?"),
    quickScout("Hono + Cloudflare の代表的な認証テンプレ構成は?"),
    quickScout("Better Auth と Clerk の棲み分けを 1 行で"),
  ]);

  // 統合判断は Opus 4.7
  const decision = await plan(scouts);
  console.log("--- final plan ---\n" + decision);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

/**
 * with-task-budgets.ts — Task Budgets beta の最小例
 *
 * Task Budget は max_tokens と違い、Claude 自身が残量を把握しながら
 * agentic loop を自制する「予算」。長時間の tool 連打や検索マラソンを
 * 計画的に打ち切らせたいときに効く。
 *
 * beta header: task-budgets-2026-03-13
 * 最小 total: 20_000
 */
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

async function main() {
  const res = await client.beta.messages.create({
    betas: ["task-budgets-2026-03-13"],
    model: "claude-opus-4-7",
    max_tokens: 64_000,
    thinking: { type: "adaptive" },
    output_config: {
      effort: "xhigh",
      task_budget: {
        type: "tokens",
        total: 100_000, // 最小 20_000
      },
    },
    system:
      "You are a research assistant. When unsure, say 'I don't know'. Keep final answer <= 400 chars.",
    messages: [
      {
        role: "user",
        content:
          "Anthropic が最近公開した agent 関連 API のうち、beta のままのものを 3 つ、各 1 行で挙げて。",
      },
    ],
  });

  for (const block of res.content) {
    if (block.type === "text") console.log(block.text);
  }
  console.log("\nusage:", res.usage);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "lib": ["ES2022"],
    "types": ["bun"],
    "strict": true,
    "noEmit": true,
    "skipLibCheck": true,
    "isolatedModules": true,
    "verbatimModuleSyntax": true
  },
  "include": ["src/**/*"]
}