Claude Code v1.0前半(v1.0.0 〜 v1.0.69)総まとめ — GA直後に固められた設計思想と機能の骨格

このリリースで何ができるようになるか

Claude Code v1.0.0〜v1.0.69の52版は、GA(正式リリース)宣言後に「Claude Codeの骨格」を固めた期間です。本まとめを読むことで、次の3つが見えてきます。

• Hooks / Sub-agents / SDKという、現在まで使われ続ける拡張3層がこの期間に出揃った経緯が分かる: v1.0.38(Hooks)、v1.0.23(SDK)、v1.0.60(Sub-agents)で「振る舞いカスタマイズ / 組み込み / 役割分担」の3拡張点が確立
• ネイティブWindows対応(v1.0.51)で対応OSが拡張された経緯が分かる: クロスプラットフォームCLIとしての条件が揃い、Bedrock APIキー対応(AWS_BEARER_TOKEN_BEDROCK)も同時に入った
• 「設定一元化 → 拡張点の三層化 → プラットフォーム拡大」の順で進んだリリース戦略が読める: v1.0.7のsettings.json一元化から始まり、Hooks / SDK / Sub-agentsを段階的に積んで、最後にWindows / PDFを足した

あなたの開発フローはどう変わるか

v2系の機能を「v1のあの版の発展形」として読めるようになる

v2系のリリースノートを読むときに「Hooksはv1.0.38で入った」「SDKはv1.0.23で同時リリースされた」「Sub-agentsはv1.0.60が起点」のような時系列が分かると、変更の重みが立体的に見えます。例えばv2系のAgent TeamsはSub-agentsの延長線、Sandbox Modeはv1.0.120 / v1.0.124のpermission強化の延長線として位置付けられます。

設計判断の歴史的背景を理解できる

なぜClaude Codeは設定がsettings.jsonに集中しているのか、なぜ/permissionsがネームスペース化されているのか、なぜCLIとSDKが同時に存在するのか —— これらの判断は、v1.0前半の特定の版で固まった結果です。背景が分かると、「もっとこうしたい」という変更要望を出すときの解像度が上がります。

Hooksの設計思想を起点から追える

Hooksはコミュニティissue(issues/712)を受けての実装で、changelogにも珍しく謝辞が載っています。v1.0.38で正式リリースされ、v1.0.41でStop / SubagentStopに分割、v1.0.48 / v1.0.54でPreCompact / UserPromptSubmitが追加、v1.0.58〜v1.0.62でSessionStart等が積まれました。登場から約30版で「どのタイミングにも割り込める」フック網が張り巡らされ、これがv2系のエージェント運用の土台になっています。

v1.0系の始まり(v1.0.0 GA)

v1.0.0は2行だけの短いchangelogです。

• Claude Code is now generally available
• Introducing Sonnet 4 and Opus 4 models

ポイントは次の2つです。

1. GA(Generally Available)宣言 — 研究プレビュー・β扱いから正式版になり、商用利用や業務導入での不確実性が下がるマイルストーンです
2. Sonnet 4 / Opus 4の同時投入 — GAのタイミングで新モデル世代が入ったことで、「Claude Code = 最新世代モデルで動くCLIエージェント」という位置付けが固まりました

この短い1行の裏には、「β期間で試行錯誤していた仕様を固定し、以降は後方互換を意識しながら積み増す」という意思表示が読み取れます。実際、v1.0.1以降は破壊的変更をできるだけ避け、deprecation → 移行パスを用意する作りに切り替わっています。

主な変更点(テーマ別)

52版を単純に時系列で追うと埋もれてしまうため、テーマごとに束ねて並べます。

1. 設定・権限モデルの整理

GA直後から設定ファイルと権限まわりの交通整理が一気に進みました。

• v1.0.7: /allowed-toolsを/permissionsにリネーム、allowedToolsとignorePatternsを.claude.jsonからsettings.jsonに移行、claude config非推奨化
• v1.0.6: CLAUDE_CONFIG_DIRをあらゆる箇所で尊重、不要なtool権限プロンプトを削減
• v1.0.28 / v1.0.31 / v1.0.45: XDG_CONFIG_HOME対応、無効JSON時のリセット修正、アトミック書き込み対応
• v1.0.51 / v1.0.61: /doctorでの設定ファイル診断、--settingsフラグで任意JSONからのロード

設定の置き場所と権限のネームスペースを早期に「一箇所に集約」する方向に舵を切ったことが分かります。

2. MCPの拡張(プロトコルと運用両面)

MCPはClaude Codeを外部システムに接続する要で、この期間に基盤が大きく広がりました。

• v1.0.4 / v1.0.8: MCPツールエラーのパース、MCP_TIMEOUTの修正
• v1.0.18: /mcpのUI強化、SSE接続の自動再接続、認証と権限周りの改善
• v1.0.27: Streamable HTTP MCPサーバ対応、リモートMCP(SSE / HTTP)でのOAuth対応、MCPリソースの@-mention対応
• v1.0.35 / v1.0.44: OAuth Authorization Server discovery、resource_linktool結果、/mcpでのtool annotations / titles表示
• v1.0.48 / v1.0.52 / v1.0.58: MCP設定の変数展開、server instructions対応、claude mcp listの健全性表示改善

「stdioサーバ接続だけ」の素朴な形から、リモート・HTTP・OAuth・ヘルスチェックまで揃った運用可能なプロトコルへ育った期間です。

3. フック(Hooks)の登場と成熟

v1.0系の最大の新機能のひとつがHooksです。コミュニティissueを受けての実装で、changelogにも珍しく謝辞が載っています。

• v1.0.38: Hooks正式リリース(issues/712のコミュニティ議論に基づく)
• v1.0.41: StopをStopとSubagentStopに分割、コマンドごとのタイムアウト、hook_event_name追加
• v1.0.48 / v1.0.54: PreCompact / UserPromptSubmitフック追加、入力にcwdを含める
• v1.0.58 / v1.0.59 / v1.0.62: CLAUDE_PROJECT_DIR環境変数、PermissionDecisionの公開、additionalContext対応、SessionStartフック追加
• v1.0.64 / v1.0.68: hook JSON出力にsystemMessageフィールド追加、disableAllHooks設定追加

登場から約30版で、「どのタイミングにも割り込める」フック網が張り巡らされ、これがv2系のエージェント運用の土台になっていきます。

4. SDKとスクリプタビリティ

対話CLIだけでなく、プログラムから呼び出せるエージェント基盤としての整備も進みました。

• v1.0.17 / v1.0.18: -pモードでのサブタスク出力、--add-dir追加、-pなしでのストリーム入力
• v1.0.22 / v1.0.23: total_cost → total_cost_usdへのリネーム、TypeScript / Python SDK同時リリース(@anthropic-ai/claude-code / pip install claude-code-sdk)
• v1.0.51 / v1.0.55: --append-system-promptのインタラクティブ利用、--system-prompt-file追加
• v1.0.59 / v1.0.64 / v1.0.68: SDKのcanUseToolコールバック、spawnプロセスのenv指定、multi-turn入力トラッキング修正

SDK登場(v1.0.23)は、Claude Codeを「CLIとして使う」から「自前のパイプラインに埋め込む」へと広げた転機です。

5. Sub-agentsとスラッシュコマンド

v1.0系後半の山場がSub-agentsです。

• v1.0.25 / v1.0.30: project / userプレフィックスの再配置、bash出力・@-mention・thinkingキーワードのカスタム対応
• v1.0.45 / v1.0.54 / v1.0.57: サブディレクトリベースのネームスペース復活、argument-hint追加、モデル指定対応
• v1.0.60: カスタムSub-agents登場(/agentsで管理)
• v1.0.62 / v1.0.64: カスタムagentの@-mentionタイプアヘッド、エージェントごとのモデル指定

v1.0.60で「一つのClaude Codeセッション内で専門化された役割を切り出す」運用が公式に可能になりました。

6. 対応環境とプラットフォーム

使える環境の広がりもv1.0系前半の特徴です。

• v1.0.11: Claude Proサブスクリプションで利用可能に、/upgradeでMaxへのスムーズな切り替え
• v1.0.25 / v1.0.29 / v1.0.48: Ghostty対応、CJK文字のレンダリング改善、シェルスナップショットを~/.claudeに移動
• v1.0.51: ネイティブWindows対応(Git for Windows必須)、Bedrock APIキー(AWS_BEARER_TOKEN_BEDROCK)対応、OTELにos.type / wsl.version追加
• v1.0.54 / v1.0.55 / v1.0.56: Windows周りのOAuthポート、モード切替のalt+m、Ctrl+Zクラッシュ修正
• v1.0.58: PDF読み取り対応
• v1.0.63 / v1.0.65 / v1.0.68: Windowsでの検索・@agent・権限チェック、サブプロセスspawnの修正

v1.0.51のネイティブWindows対応はこの時期の大きな転換点です。

特筆すべき版ピックアップ

52版のうち、個別に掘り下げておく価値がある版を4つ挙げます。

v1.0.11(Claude Pro対応 + /upgrade) 有料プラン購読者がCLIを使える導線が開通し、普及のボトルネックがひとつ外れた版です。

v1.0.23(TypeScript / Python SDK) 対話CLIから、アプリケーション組み込み可能なエージェントランタイムへと射程が広がった転機です。

v1.0.38(Hooks正式化) コミュニティissueを受けての実装で、「なぜこのタイミングで入ったか」がはっきりしている珍しいリリースです。以降のエージェント運用はHooksを前提に設計されるようになります。

v1.0.60(カスタムSub-agents) /agentsで専門化エージェントを定義できるようになり、のちのAgent Teamsやマルチエージェント運用の基礎が据わった版です。

主要版の早見表

公開初期からわかるClaude Codeの設計思想

v1.0系前半の52版を俯瞰すると、いくつかの設計思想が浮かび上がってきます。あくまで一つの読みとしての整理です。

1. 「設定は1ファイル、権限は1ネームスペース」に寄せる v1.0.7でsettings.jsonに集約しclaude configを非推奨にしたのは、CLIとしての表面積を縮める意思の表れと見えます。設定ファイルが散らばるとチーム運用・CI組み込み・移植のすべてが重くなるため、早期に一本化しておく判断だった、と読めそうです。

2. 拡張点を「Hooks」「MCP」「Sub-agents」の三層に分ける 振る舞いのカスタマイズはHooks、外部システム接続はMCP、役割分担はSub-agents、という住み分けがv1.0.38 → v1.0.60の流れで固まりました。「同じことを別の場所でもできる」重複拡張点を作らず、責務を分けている設計が印象的です。

3. CLIとSDKを同時に育てる v1.0.23でSDKを同時リリースしたのは、Claude Codeをユーザ向けCLIに閉じず、組み込まれるランタイムとしても使わせる布石だったように見えます。canUseToolや--system-prompt-fileはこの「組み込みで使う」ユースケースを支える動きです。

4. プラットフォーム拡大は後方互換優先で Windows対応(v1.0.51)やPDF対応(v1.0.58)も、既存の振る舞いを壊さないまま足していく進め方が徹底されています。後続パッチがCtrl+Z修正や.bashrcのないユーザ対応などエッジケース潰しに費やされているのも、既存ユーザを落とさない運用姿勢の表れと言えそうです。

まとめ

• GA直後の52版で、Hooks / SDK / Sub-agentsの拡張3層が出揃った: v1.0.38 → v1.0.23 → v1.0.60の順序で揃い、現在のClaude Codeの拡張モデルが完成
• 設定はv1.0.7でsettings.json一元化、権限はv1.0.7で/permissionsに集約: CLIとしての表面積を縮める初期判断
• ネイティブWindows対応(v1.0.51)とBedrock APIキー対応で、エンタープライズの土俵に乗った
• fix-only版と大型機能版が交互に挟まるリズムは、v2系にも引き継がれている: 「大きな機能投入 → 数日で周辺バグを潰す」呼吸

この期間の骨格は、v1.0.70以降とv2系での大型機能(Plan Mode / Agent Teams / Sandbox / Native Binary化)の基礎になっています。続編のv1.0系後半のまとめやv2.0系前半のまとめもあわせて読むと、Claude Codeが現在の形に至った道筋が立体的に見えてくるはずです。