株式会社Good Labでエンジニアをしている コータロー です。
日々、Java・SQL・Gitなどの技術情報や、新人エンジニア向けの学習ノウハウ、
AI活用についての情報を発信しています。
Good Labについて気になった方は、コーポレートサイトもぜひご覧ください。
▶コーポレートサイト
はじめに
前回記事(v2.1.74〜v2.1.84 アップデート)でカバーした 2026年3月27日以降、Claude Code は 約1ヶ月半で v2.1.85 → v2.1.138 まで一気に進化 しました。
本記事では、その間のリリースから「業務利用しているエンジニアにとって押さえておくべきポイント」だけを厳選してまとめます。
カバー範囲: 2026年3月末〜5月10日(v2.1.138 時点)
| トピック | 概要 |
|---|---|
| Claude Opus 4.7 リリース | 1M context・xhigh effort・新トークナイザー |
| プラグインマーケットプレイス強化 |
--plugin-url / --plugin-dir ZIP 対応 |
| Hooks への effort level 連携 |
$CLAUDE_EFFORT 環境変数追加 |
claude project purge コマンド |
プロジェクト状態を一括削除 |
| Agent SDK の進化 | Hook event streaming・defer 判断・strict MCP |
# バージョン確認とアップデート
claude --version
npm update -g @anthropic-ai/claude-code
1. Claude Opus 4.7 が登場(2026年4月16日)
Claude Code 利用者にとって最大のニュースは、Claude Opus 4.7 のリリースです。Claude Code、Cursor、GitHub Copilot などから初日から利用可能になりました。
押さえておくべき変更点
| 項目 | Opus 4.6 | Opus 4.7 |
|---|---|---|
| コンテキストウィンドウ | 200K(1Mはβ) | 1M(標準価格) |
| 価格(input / output) | $15 / $75 | $5 / $25 |
| 最大出力トークン | 64K | 128K |
| トークナイザー | 旧 | 新(最大35%トークン増の可能性) |
| Effort 推奨 | high | xhigh(コーディング用途) |
| 画像最大解像度 | 1568px | 2576px / 3.75MP |
| SWE-bench Verified | – | 87.6% |
Claude Code から見た意味
- 1M コンテキストが標準価格に: 大規模リポジトリの読み込みでも長コンテキスト追加料金なし
-
xhigh effort 追加: コーディング/エージェント用途では
xhighが推奨デフォルト -
新トークナイザー: 同じテキストでも消費トークンが最大1.35倍になる可能性があるため、
max_tokensの見直しを推奨
破壊的変更(Messages API を直接使う場合)
Claude Code 経由なら自動で吸収されますが、Agent SDK / Messages API を直接叩いている場合は注意です。
# Before(Opus 4.6)
thinking = {"type": "enabled", "budget_tokens": 32000}
# After(Opus 4.7)— budget_tokens は 400 エラー
thinking = {"type": "adaptive"}
output_config = {"effort": "xhigh"}
-
temperature/top_p/top_kの非デフォルト値も 400 エラー - Thinking content はデフォルトで非表示(
display: "summarized"で復元)
2. プラグインマーケットプレイス強化(v2.1.126・v2.1.128・v2.1.129)
3月末時点では公式マーケットプレイス中心でしたが、4月末以降に 任意の URL や ZIP からプラグインを読み込める ようになりました。
--plugin-url で URL 指定インストール(v2.1.129)
# 任意のマーケットプレイス JSON を URL で追加
claude --plugin-url https://example.com/my-marketplace.json
--plugin-dir で ZIP アーカイブ対応(v2.1.128)
# ローカルの ZIP ファイルから直接ロード
claude --plugin-dir ./my-plugin.zip
エンタープライズ向けブロックリスト
blockedMarketplaces 設定キーが追加され、組織レベルで信頼できないマーケットプレイスを遮断できるようになりました。
// .claude/settings.json
{
"blockedMarketplaces": [
"https://untrusted.example.com/marketplace.json"
]
}
/mcp コマンドの改善
- ツール数を表示し、0 ツールサーバーをフラグ付け
- 再接続時に再宣言されたツール一覧をサマリ表示
3. Hooks に effort level が連携(v2.1.133)
これは小さな変更ですが、フックを書いている人には嬉しい追加です。現在の effort level がフック側でも参照可能 になりました。
JSON 入力フィールド
フックハンドラに渡される JSON に effort.level が追加されました。
{
"session_id": "abc123",
"tool_name": "Bash",
"effort": {
"level": "xhigh"
}
}
環境変数 $CLAUDE_EFFORT
Bash ツール内でも $CLAUDE_EFFORT で参照できます。
// .claude/settings.json
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "echo \"[effort=$CLAUDE_EFFORT] running bash tool\" >> /tmp/claude.log"
}
]
}
]
}
}
xhigh の時だけ重い静的解析を走らせる、low の時はスキップする、といった出し分けが書けます。
4. claude project purge コマンド(v2.1.126)
地味に便利な新コマンドです。プロジェクトの Claude Code 状態(履歴・キャッシュ・設定など)を一括削除できます。
# カレントプロジェクトの状態を削除
claude project purge
# パスを指定して削除
claude project purge /path/to/project
「セッション履歴が肥大化してきた」「実験プロジェクトを片付けたい」といったときに使えます。
5. /resume の高速化と進捗表示の改善(v2.1.116〜)
大きなセッションを扱うユーザーに刺さる改善です。
-
/resumeが大型セッションで最大67%高速化(40MB+ セッションで顕著) - インライン thinking 進捗表示: "still thinking" / "thinking more" / "almost done thinking" の段階表示
- 画像のオートダウンサンプリング: 2000px超の画像はペースト時に自動縮小
- オーバーサイズ画像の履歴除去: API 400 エラー時に自動除去・再試行
6. ゲートウェイ統合の改善(v2.1.126〜v2.1.129)
ANTHROPIC_BASE_URL に Anthropic 互換ゲートウェイを指定している場合、/v1/models エンドポイントから動的にモデル一覧を取得できるようになりました。
# オプトインで有効化(v2.1.129以降)
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
export ANTHROPIC_BASE_URL=https://your-gateway.example.com
claude
/model ピッカーがゲートウェイの /v1/models 結果を表示するようになります。社内 LLM ゲートウェイを運用しているチームに特に便利な機能です。
7. Bedrock service tier 選択(v2.1.122)
AWS Bedrock 経由で Claude を使っているチーム向け。ANTHROPIC_BEDROCK_SERVICE_TIER 環境変数でサービスティアを選べるようになりました。
export ANTHROPIC_BEDROCK_SERVICE_TIER=priority
claude
8. Agent SDK の主要更新(v0.1.71 〜 v0.1.80)
Claude Code 本体だけでなく、@anthropic-ai/claude-agent-sdk(Python版は claude-agent-sdk)も活発に更新されています。
主要バージョンと変更点
| バージョン | 日付 | 主な変更 |
|---|---|---|
| v0.1.74 | 2026-05-06 | Hook event streaming、defer 判断、strict MCP 設定、xhigh effort |
| v0.1.76 | 2026-05-06 |
api_error_status 追加、Permission suggestions デシリアライズ修正 |
| v0.1.77 | 2026-05-08 |
allowed_tools の "Skill" を非推奨化(skills オプションに移行) |
| v0.1.80 | 2026-05-09 | Bundled CLI を v2.1.138 に更新 |
Hook event streaming(Python SDK)
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions
async def main():
options = ClaudeAgentOptions(
include_hook_events=True, # ← 追加されたオプション
)
async with ClaudeSDKClient(options=options) as client:
await client.query("Refactor this codebase")
async for message in client.receive_response():
print(message)
asyncio.run(main())
Skill 指定の変更
# 旧(非推奨)
options = ClaudeAgentOptions(allowed_tools=["Skill"])
# 新
options = ClaudeAgentOptions(skills=["my-skill"])
9. 個人開発・業務利用での実践 Tips
Tips 1: Opus 4.7 にアップグレードしたら max_tokens を見直す
新トークナイザーで最大35%トークン増の可能性があるため、コンパクション閾値が早く来ます。SDK で max_tokens を上げ、Claude Code 利用なら /usage でトークン消費を観察しましょう。
Tips 2: 既存のフックを effort 連携にアップグレード
CI/重い検証は xhigh の時のみ走らせる、といった条件分岐を Hooks に組み込むとコスト最適化できます。
#!/bin/bash
# .claude/hooks/post-edit.sh
if [ "$CLAUDE_EFFORT" = "xhigh" ]; then
npm run lint && npm run test
else
npm run lint
fi
Tips 3: プラグインは claude-plugins-official を最初に確認
公式マーケットプレイス(anthropics/claude-plugins-official)は Claude Code 起動時に自動で利用可能です。
/plugin
# Discover タブから公式プラグインを参照
Tips 4: 大型プロジェクトは claude project purge で定期メンテ
長期保守しているリポジトリは履歴ファイルが肥大化しがちです。月1回 purge するだけで /resume 体感速度が改善します。
10. まとめ
2026年4月〜5月のアップデートで筆者が「これは業務に効く」と感じたのは以下の3点です。
- Opus 4.7 + 1M context が標準価格: 大規模コードベースの読み込みハードルが下がった
-
xhigheffort + Hooks 連携: コスト/品質のトレードオフを自動化できる - プラグイン URL/ZIP ロード: 社内独自マーケットプレイスを建てやすくなった
特に Good Lab のような複数プロジェクトを並行で進めるエンジニアには、claude project purge と /resume 高速化が地味に効きます。
次回(おそらく6月版)も継続してウォッチしていきます。
参考
- Claude Code Changelog(公式)
- anthropics/claude-code(GitHub)
- What's new in Claude Opus 4.7(公式ドキュメント)
- Effort levels(公式ドキュメント)
- Task budgets(公式ドキュメント)
- Discover and install plugins(公式ドキュメント)
- Model configuration(公式ドキュメント)
- anthropics/claude-agent-sdk-python Releases
- anthropics/claude-plugins-official
@kotaro_ai_lab
AI活用や開発効率化について発信しています。フォローお気軽にどうぞ!