Claude Code v2.1.27 — PR番号でセッションを呼び戻せる、PR起点ワークフローの整備

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

Claude Code v2.1.27は9項目の小粒パッチですが、PR番号を起点にClaude Codeセッションを呼び戻せる動線が初めて成立する点で、PR駆動の開発フローを回しているチームには意味の大きい版です。

• --from-prフラグでGitHub PR番号 / URLからセッションを直接resumeできる
• gh pr createでPRを作ったセッションが自動でPRに紐付く(数日後・別マシンからもPR番号で開ける)
• gatewayユーザー(Bedrock / Vertex / Foundry)でのcontext管理validationエラーが解消
• Windows + .bashrc、子プロセスspawn時のコンソール明滅、VSCode拡張のOAuthトークン期限切れによる401エラーをまとめて修正

直前のv2.1.20でプロンプトフッタにPRレビューステータスインジケータが入った流れを受け、本版でセッション側がPRに紐付く仕組みが揃いました。

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

gh CLIでPRを作るチーム

これまでのClaude Codeでは、レビューで差し戻しを受けてから数日後に再開したい、別マシンで続きを触りたい、というケースで--resumeからセッション一覧を目で探すしかありませんでした。「どのセッションがどのPRの作業だったか」が人間の記憶頼りだったわけです。

本版以降は次のように動きます。

# 作業ディレクトリでPRを作成 → セッションが自動的にPR #123に紐付く
gh pr create --title "add: feature X"
 
# 数日後、別端末で再開
claude --from-pr 123
# または
claude --from-pr https://github.com/owner/repo/pull/123

PR番号という外部に公開され、チーム全員が共有できる識別子を起点にセッションを呼び戻せるため、個人のセッションIDや履歴に依存せずに作業を再開できます。

Bedrock / Vertex / Foundry経由の企業利用

gatewayユーザーで発生していたcontext管理のvalidationエラーが、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1の設定で回避できるよう挙動が修正されました。前版のv2.1.25でもbeta header validationエラーに同じフラグでの回避が用意されており、本版でcontext管理側にも同じ回避経路が揃った形です。企業ゲートウェイ経由で運用しているチームは更新する価値があります。

Windows + .bashrc、子プロセス、VSCode長時間セッション

Windows環境で.bashrcを持つユーザーがbashコマンドを実行できなくなっていた回帰、子プロセスをspawnするたびにコンソールウィンドウが一瞬表示される明滅、VSCode拡張で長時間セッション中にOAuthトークンが期限切れになり401エラーが出ていた問題が、まとめて修正されています。.bashrc修正は後続のv2.1.30でも再度言及されているため、Windows+.bashrc構成ではv2.1.30まで合わせて確認しておくのが安全です。

ツール呼び出しのデバッグ追跡

--from-prと同じ新機能リストに「ツール呼び出しの失敗と拒否をデバッグログに追加」が並んでいます。PRに紐付いたセッションを後から開いたときに、レビュアーが「どのコマンドがなぜ拒否されたのか」を追跡できるようにする下地と読めます。--from-pr単体ではなく、PR起点でセッションの履歴を追う一連の体験を支える基盤整備として機能している部分です。

主な変更点

新機能

• --from-prフラグ: 特定GitHub PR番号またはURLに紐付くセッションを再開。例: claude --from-pr 123
• gh pr create時の自動リンク: gh pr create経由でPRを作ると、現在セッションが自動でPRに紐付く
• ツール呼び出し失敗 / 拒否のデバッグログ追加: ツール失敗や権限プロンプトでの拒否がデバッグログに記録される

修正

gh pr createとの統合が示すもの

注目すべきは、PR紐付けのトリガーがgit pushでもブランチ名でもなく、gh pr createという具体的なコマンドに限定されている点です。これは以下を示唆しています。

• Claude Code側はgh CLIの出力(PR番号 / URL)を捕まえて紐付けている
• 直接GitHub Web UIでPRを作った場合は自動リンクされない可能性が高い(changelogには限定的な記述)
• gh CLIをPR作成のデフォルトにしているチームは、そのまま恩恵を受けられる

gh依存を前提に機能が設計されているため、GitHub CLIをエディタのターミナルで使うワークフローを持っているチームには追加設定なしで効きます。一方、hubや独自スクリプト、Web UI中心のフローでは手動の紐付け手段が別途必要になります(changelogに手動紐付けコマンドの記載はありません)。

前後版との位置付け

v2.1.27の変更は、直近数版の文脈に置くと役割がはっきりします。

v2.1.20から始まったPR統合の流れが、v2.1.27でセッション単位の紐付けまで拡張され、v2.1.30以降の--resume性能改善や/debugまで含めると、「長く使い続けるためのセッション運用基盤」を順番に整備している流れが読めます。gatewayユーザー向けのvalidation修正が複数版にわたって続いている点は、Bedrock / Vertex / Foundryを介した企業利用が拡大し、エッジケースを丁寧に潰している段階を示していそうです。

まとめ

• gh CLIでPRを作るチームは更新推奨: PR番号を起点にセッションを呼び戻せる体験が成立
• Bedrock / Vertex / Foundry経由なら更新推奨: context管理validationエラーの回避経路が揃う
• Windows + .bashrc、VSCode長時間セッションなら更新推奨: 該当環境の不具合が同時に解消
• Web UI中心 / 通常ローカル開発なら任意: --from-prは番号指定で部分的に使えるが優先度は低い

更新はclaude updateで取得できます。