Claude Code 2.1.329の変更点:ゲートウェイのmax_tokens、/tasks、/code-reviewと修正

Claude Code 2.1.329(2026年11月19日公開)では、ゲートウェイ環境でのmax_tokens自動再試行が廃止され、/tasksへのスケジュール済みタスクやフォークの表示追加、対象未指定の/code-reviewでほとんどのモデルが現在のブランチとデフォルトブランチの差分全体をレビューする変更、フックの宣言元を示す信頼警告の追加、~/.claude.jsonの初期化およびmacOS・VS Code・使用クレジット関連の不具合修正が行われました。更新手順、ゲートウェイ接続経路の比較、同日公開の2.1.328の主な変更もまとめています。

目次
Claude Code 2.1.329の変更点:ゲートウェイのmax_tokens、/tasks、/code-reviewと修正

Claude Code 2.1.329は2026年11月19日に公開されました。本バージョンでは、ゲートウェイ経由でのmax_tokens自動再試行の廃止、/tasksの表示拡張、/code-reviewと保存済みスケジュールタスクの挙動変更に加え、~/.claude.jsonの初期化やmacOS・VS Codeでのサインアウトに関する不具合修正が含まれます。対象となるのは、ターミナル、VS Code、Claude Desktopを使う開発者、およびLLMゲートウェイやPro・Maxプランの使用クレジットを運用するチームです。まずclaude --versionで現在のバージョンを確認し、claude updateで更新してください。使用中のゲートウェイの出力上限が低い場合は、あわせてCLAUDE_CODE_MAX_OUTPUT_TOKENSを設定します。

Claude Code 2.1.329の接続経路を選ぶ

2.1.329への更新は、ゲートウェイ側の出力トークン上限、セルフホスト型ゲートウェイのallow_cidrs起動時警告、そしてPro・Maxプランの月間クレジット表示に影響します。個人設定やチーム設定を変更する前に、現実的な接続経路を比較します。

接続経路アカウントおよび地域の要件課金単位選ぶ目安
Claude Pro / MaxサブスクリプションAnthropicのサポート対象地域における有料のclaude.aiアカウント(Pro、Max、Ultra、Team、またはEnterprise。無料のclaude.aiプランは対象外)サブスクリプションに含まれる利用枠と任意の使用クレジットRemote Control、音声入力、またはWeb版とCLIの一体型利用が必要な場合
Anthropic Console APIへの直接接続Anthropicのサポート対象地域におけるClaude Consoleアカウント(platform.claude.com、APIキーまたはConsoleサインイン)APIトークン単位の従量課金プロキシを挟まずにAnthropic APIへ直接課金したい場合
組織向けまたはセルフホスト型ゲートウェイ組織管理のプロキシ(企業IdPサインインを備えたClaude apps gatewayなど)と、上流のAPIまたはクラウド認証情報上流のAnthropic Console、Bedrock、Agent Platform、またはFoundryアカウントへのトークン単位課金チームで予算の一元管理、モデルアクセス制御、監査ログ、管理設定が必要な場合
BetterToken従量課金APIゲートウェイBetterTokenアカウントとコンソールで発行したAPIキー(API利用にclaude.aiアカウントは不要)トークン単位の従量課金(購入した有償残高は月次でリセットされません)自前でゲートウェイを運用せずにAnthropic互換のClaude API接続や複数モデルの選択肢を得たい場合

Claude Code 2.1.329をBetterTokenに接続する

BetterTokenは独立したマルチモデルAPIプラットフォームであり、Anthropicの公式製品ではありません。Claude Code向けのAnthropic互換ベースURLはhttps://bettertoken.aiです。Claude Code側が自動的に/v1/messagesを付与するため、ANTHROPIC_BASE_URLには/v1を含めないでください。

2026-11-20時点で、BetterTokenのAnthropic互換エンドポイントにはclaude-sonnet-5-5、claude-opus-5-5、claude-haiku-5-5、claude-fable-5-2が掲載されています。これらはいずれも1Mトークンのコンテキストウィンドウと最大128K出力に対応します(Sonnet 5.5、Opus 5.5、Haiku 5.5は同期出力)。あわせて、claude-haiku-4-5-20251001(200Kコンテキスト、最大同期出力64K)も利用できます。規模の大きいセッションを実行する前に、現在の料金ページで最新の入力・出力・キャッシュ単価を確認してください。

テスト用セッションとして、Bash上でAPIキーを画面に表示せずに読み込み、必要な環境変数を設定します。以下のコマンドでは、ベースURL、認証トークン、既定モデルおよびSonnet・Haiku・Opusの各役割に対応するモデルIDをエクスポートします。

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"

続いて単発のプロンプトを送り、接続が通るかを確認します。

claude -p "Reply with only: OK"

401や接続エラー、モデルエラーが出ず、単純にOKと返れば認証は正常です。次にclaudeを起動して/statusを実行してください。Anthropic base URLがhttps://bettertoken.aiになっていること、そして認証行がclaude.aiログインではなくANTHROPIC_AUTH_TOKENを表示していることを確認します。起動時に認証元の競合が警告された場合は、/logoutを実行して保存済みのclaude.aiセッションを削除し、シェル側でANTHROPIC_API_KEYが設定されていれば解除してください。

これらの設定をセッション間で保持するには、~/.claude/settings.json(Windowsでは%USERPROFILE%\.claude\settings.json)の"env"ブロックに追記し、Claude Codeを完全に再起動します。詳細な設定例はBetterTokenのClaude Code設定ガイドまたはClaude Code API設定ページを参照してください。CLAUDE_CODE_MAX_OUTPUT_TOKENSは、選択したモデルの出力上限がClaude Codeのリクエストサイズより低い場合にのみ追加します。任意のCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1を設定すると自動更新が無効になるため、更新時は手動でclaude updateを実行してください。なお、Remote Controlと音声入力はclaude.aiでのログインが必須であり、APIキーとカスタムベースURLの構成では利用できません。

BetterTokenアカウントを作成する

組織ですでに独自のプロキシやClaude apps gatewayを運用している場合は、既存の管理設定を維持するか、Anthropic公式のClaude CodeをLLMゲートウェイに接続するガイドに従い、ANTHROPIC_BASE_URLとあわせてANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、またはapiKeyHelperを設定してください。

ゲートウェイのmax_tokensエラーとallow_cidrs起動時警告

Claude Code 2.1.329では、2.1.326で導入された自動再試行の仕組みが削除されました。2.1.326ではリクエストのmax_tokensがモデルの上限を超えた場合、APIエラーが返す最大値を使ってClaude Codeが自動的に再試行していました。Claude Code公式変更履歴によると、2.1.329はこの自動再試行を行いません。

この変更は、Claude Codeが要求する値よりも少ない出力トークン数しか受け付けないモデルへゲートウェイ経由で接続しているチームに影響します。Claude Code環境変数リファレンスによると、Claude Codeが識別できないカスタムモデルIDは既定で32000出力トークン(上限128000)として扱われます。ゲートウェイ側がそのIDに対してより低い出力上限のモデルを割り当てている場合、リクエストは暗黙的に再試行されず、max_tokensエラーで失敗するようになります。

利用するモデルの確認済み出力上限を、シェルまたは~/.claude/settings.jsonのCLAUDE_CODE_MAX_OUTPUT_TOKENSに明示してください。次の例はBashで上限値を設定する手順です。

export CLAUDE_CODE_MAX_OUTPUT_TOKENS="16384"

16384を実際のモデルの出力上限に置き換えてClaude Codeを再起動し、短いプロンプトを送信してmax_tokensエラーが解消されたことを確認します。ゲートウェイが出力長ではなく入力長によってリクエストを拒否する場合は、Claude Codeの1Mコンテキストウィンドウに関するゲートウェイエラー修正ガイドを確認してください。

Anthropicのセルフホスト型Claude apps gatewayを運用している管理者向けにも、起動時の警告が強化されました。access_control.allow_cidrsが空の場合、2.1.329は起動のたびにテキストログへ枠付きでnever expose the gateway to the public internetという通知を出力します(ただし、trusted_proxiesもpublic_urlも設定せずにループバックアドレスへバインドしている場合、この起動警告は表示されません)。Claude apps gateway設定ガイドのとおり、access_controlの両リスト(allow_cidrsとdeny_cidrs)が空のままだとゲートウェイはあらゆるクライアントアドレスからの接続を受け付けてしまい、到達制限がネットワーク層頼みになります。ゲートウェイは開発者マシン上でコマンドを実行する管理設定を配信できるため、この露出リスクは無視できません。access_control.allow_cidrsにプライベートアドレス範囲を登録し、ゲートウェイ本体およびその前段機器がパブリックインターネットから到達できない状態を維持してください。ロードバランサー、ポートフォワード、またはトンネルが通信を中継する場合、listen.trusted_proxiesに登録してよいのは、各着信接続のアドレスをフロントエンド側が付加し、末尾のX-Forwarded-Forエントリを開発者が書き換えられない構成に限られます。開発者が接続元として使うアドレスや範囲は決して登録しないでください。条件を満たす中継機器を記載し忘れると、ゲートウェイはクライアントではなく中継機器のアドレスを認識してしまいます。設定後はゲートウェイを再起動し、警告が消えたことを確認します。

/tasks、保存済みスケジュールタスク、および/code-reviewの動作変更

バージョン2.1.329では、実行中のセッション作業が/tasksにどのように表示されるか、そして/code-reviewが差分をどう算出するかが変わっています。定期実行ジョブやブランチレビューを再開する前に、両方の変更点を確認してください。

/tasksでのスケジュールタスク、/loop起動、フォークの管理

/tasksには、現在のセッションに紐づくスケジュールタスク、/loopの起動予約、ゴール、およびこの会話のフォークが表示されるようになりました。一覧で項目を選び、xキーを押して確認に応じると、対象の実行を停止できます。また、/tasksのヘッダーとフッターのバックグラウンド件数表示は、シェル、モニター、MCP呼び出し、エージェント、ワークフロー、スケジュールタスクを合算した1つの数値に統一されました。

以前のバージョンで保存したスケジュールには、更新後の手動対応が必要です。新たにサインインしたセッションでは、旧バージョンで保存されたスケジュールタスクの大半を登録し直す必要があります。ただし、元のセッションをclaude --resumeで再開した場合は、旧タスクもそのまま実行されます。終了時にExit and stop tasksを選択すると、現在のセッションのスケジュールタスクが停止し、再開時に自動起動しなくなります(Claudeの応答中に終了した場合を除く)。Cloud、Desktop、および/loopによるスケジュール方式の使い分けについては、Claude Codeのタスクスケジュール設定ガイドを参照してください。

/code-reviewのデフォルトブランチ差分とプルリクエスト検証

対象を指定せずに/code-reviewを実行すると、ほとんどのモデルでデフォルトブランチに対するブランチ全体の差分がレビューされるようになりました。複数コミットを含むブランチで/code-reviewが差分を取りこぼす不具合も修正されています。

プルリクエストのレビュー判定も厳格化されました。以前は/code-review <pr number>を実行しても、プルリクエストではなく手元でチェックアウト中のローカルブランチを黙ってレビューしてしまう場合がありました。2.1.329ではgh pr diffでプルリクエストの差分を読み取り、取得できない場合はその旨を明示します。gh pr diffが失敗または拒否された場合、/code-review <pr number> --fixやプルリクエストURLを渡した/code-reviewはレビューを行わずに停止します。

さらに、ほとんどのモデルで発生していた2つのレビュー不具合も解消されました。存在しない~/.claude/CLAUDE.mdを探して権限確認プロンプトで止まる問題がなくなり、mediumレベルで実行したレビューの結果カードにhighと誤表示される現象も修正されています。

フックの信頼警告、MCP診断、および/statusの拡張

Claude Code 2.1.329では、フォルダのフック、リモートHTTP MCPサーバー、管理対象マーケットプレイス、Code Modeの診断機能が強化されました。

  • フォルダおよび管理設定のフック: 信頼確認ダイアログに、そのフォルダのフックがどこで宣言されているかが表示されるようになりました。Claude Desktopなどの非対話型ホストでは、管理設定内のフック読み込みに失敗すると会話内に警告が出ます。VS Codeでは、信頼プロンプトを拒否した後にメッセージ入力欄の上へReview trustを含む案内行が追加され、ウィンドウを再読み込みせずに再度プロンプトを開けます。意図しないプロジェクトフックやリモートMCPサーバーを点検する手順は、Claude CodeのフックとMCP接続の監査ガイドを活用してください。
  • リモートHTTP MCPの診断: /mcp内の各サーバーページにServer message行が追加され、リモートHTTP MCPサーバーが接続を拒否した際のJSON-RPCエラーメッセージを確認できるようになりました。2.1.329は古いプロトコルバージョンに残っていた大半のHTTP MCPサーバーへ自動で再接続し、バックグラウンドMCPタスクの停滞を防ぎます。また、クライアント登録が廃止されたサービス(HTTP 410 Gone)に対してclaude mcp loginや/mcpが「Claude Codeからのサインインを受け付けない」と誤って表示する不具合を修正し、認証情報を削除した直後に進行中のトークン更新がサーバーへ再サインインしてしまう問題も防ぎます。
  • マーケットプレイス自動更新の状態: /statusにMarketplace auto-update行が加わり、自動更新されない管理対象マーケットプレイス名とその理由が明記されます。
  • Code Modeのテレメトリとフック: OpenTelemetryのイベントとメトリクスが有効な状態でもCode Modeをオンにできるようになりました。コードが実行する各ツール呼び出しはイベントを送信しますが、トレーシング有効時は引き続きCode Modeが無効のままです。また、テレメトリ、非必須通信、または機能フラグがオフの状態でもCode Modeが起動するようになりました(管理者は管理設定で無効に維持できます)。失敗したPreToolUseフックは、コマンド・HTTP・MCPツールフック側で"onFailure": "block"を設定しない限り、Code Modeスクリプトのツール呼び出しを拒否しません。さらに、Code Modeは256 MiBを超える行範囲の読み込みを拒否し、暴走ループがメモリを埋め尽くす前に停止します。

~/.claude.jsonの初期化、サインアウト、および使用クレジットの修正

2.1.329の変更履歴に記載された91件のバグ修正のうち、頻繁に作業を中断させていた4つの信頼性問題が解消されました。

1つ目は~/.claude.jsonの保護です。ネットワーク停滞やファイルロックによってファイルが読み取れず保存処理中に内容が消去された際、~/.claude.jsonが既定値へ初期化される不具合が修正されました。アップグレードによって今後の書き込みは保護されますが、旧ビルドですでにファイルが消去された場合は設定の復元または再適用が必要です。

2つ目はmacOSとVS Codeでのサインアウトループ修正です。macOSではログイン更新時にClaude Code-write-check項目を使ってKeychainへの書き込み可否を検査するようになりました。Keychainの読み取りはできても保存ができない場合、該当セッションのみが有効期限切れ時に理由を示して停止し、他のセッションはサインイン状態を維持します。VS Codeでは、トークン更新の応答に10〜30秒かかった際に、すべてのウィンドウとターミナルから一斉にサインアウトされる問題が解消されました。X上のコミュニティ投稿である@alexmichael氏の投稿(2026-11-19 22:17 UTC)でも、これらのサインアウト修正と~/.claude.json修正が/tasksや/code-reviewと並んで取り上げられており、公式変更履歴の内容と一致しています。

3つ目はProおよびMaxプランにおける使用クレジット確認の安定化です。/usage-creditsはブラウザを開いた後にPro・Maxユーザーへ再ログインを求めなくなりました。ブラウザが開けずタスクがクレジット待ちで一時停止した場合に、8秒でリンクが消えてしまう問題も修正されています。さらに、使用クレジットが枯渇したり月間上限に達したりした状態で/usageが「使用クレジットがオフ」と誤表示する不具合や、その上限によってクレジット前提のモデルがブロックされた際に/modelがPro・Maxユーザーへ通知しない問題も直りました。サブスクリプション上限で作業中のタスクが停止した際は、Claude Codeの利用上限からの復旧ワークフローを参考にGitチェックポイントを保存してから接続経路を切り替えてください。

4つ目はエディタ関連の2件の修正です。IDE経由で差分を承認した際にファイル末尾の改行が削られる不具合、およびVS Codeで差分保存により編集を承認した際にバイトオーダーマーク(BOM)が失われる不具合が解消されました。加えて、/terminal-setupがブロックコメント周辺でVS Codeの設定やキーバインドを破損する問題と、keybindings.jsonに閉じていない文字列がある状態でShift+Enter割り当てを失ったまま成功と報告する問題も修正されています。

11月19日に同日公開:Claude Code 2.1.328の主な変更点

Anthropicは同じ2026年11月19日の01:14:04Zにv2.1.328を公開し、その約21時間後の22:14:41Zにv2.1.329を公開しました。2.1.327から2.1.329へ直接更新するチームには、以下の2.1.328の変更も同時に適用されます。

  • ゲートウェイのタイムアウトとベータヘッダー: CLAUDE_STREAM_IDLE_TIMEOUT_MSが、ゲートウェイ、カスタムベースURL、クラウドプロバイダー上の5分接続制限を正しく延長するようになりました。ベータヘッダーを拒否するゲートウェイ配下、あるいはBedrock、Agent Platform、Foundry、Claude apps gateway上でCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASを設定した際、Claude Desktop以外で自動モードが毎ターン失敗する問題も修正されています。さらに、入力スキーマがanyOf、oneOf、allOfで始まるMCPツールが、サードパーティプロバイダー上やテレメトリ・機能フラグ無効時に消える不具合も解消されました。
  • 焦点を絞った/code-reviewレポート: ほとんどのモデルで、/code-reviewはバグとCLAUDE.md違反のみを報告する仕様になりました。コードの再利用や整理の提案には/simplifyを使用してください。また、ほとんどのモデルで各指摘にImportant、Pre-existing、Nitのいずれかのラベルが付き、要約末尾に修正案が示され、問題がなければ"Code review found no issues."と出力されます。
  • スケジュールタスク保護とMCPフック: サードパーティプロバイダー上やテレメトリ・機能フラグ無効時にタスクファイルが読み取れない状況でスケジュールタスクを保存しても、他のプロジェクトタスクが消去されなくなりました。また、コマンドフックやHTTPフックと同様に、mcp_toolフックでも"onFailure": "block"が利用できるようになっています。

LLM ワークフローを最適化しませんか?

単一 API でモデルを接続し、キーと AI コストを管理できます。

無料で始める