2026.11.21AI WEB構築

next upgrade --agentに版上げを任せる条件|人が見る3つの所

AUTHORCreavePlus 編集部
next upgrade --agentに版上げを任せる条件|人が見る3つの所
この記事の目次

Next.jsの脆弱性の知らせを受けて版上げをAIのエージェントに頼むなら、Next.js 16.4で入った next upgrade --agent を使うのが近道です。脆弱性を直すための版上げは next upgrade --agent で別のGitのworktreeに任せてよく、本番に出す前の差分とビルドとプレビューの確認だけは人が行うのが弊社の結論です。反対にページが数枚で自分で npm install next@latest を実行してビルドを確かめられるなら、エージェントを使う必要はありません。

版上げを急ぐ理由ははっきりしています。Next.jsの2025年12月3日のセキュリティの知らせではCVSS 10.0の脆弱性に対して15.0.5から16.0.7まで7つの版の系列ごとに修正版が示されました。修正版が出てもどの版に上げるかを選ぶのは利用者なので、選び間違えない手順を持っておく必要があります。

この記事では next upgrade --agent がエージェントに何を渡すのかを説明します。そのうえで2026年11月時点の公式の説明に沿って、人が見る所を決めて版上げする手順を書きます。

next upgrade --agentは上げ先の版を決めてからエージェントに渡す

next upgrade --agent は上げ先の版をCLIが先に決め、その版に必要な説明をそろえてからエージェントに作業を渡す命令です。2026年10月6日のNext.js 16.4の発表で入り、App RouterとPages Routerのどちらでも使えます。

Next.js公式の説明(2026年10月2日更新)によると、CLIはまず入っている版とリリースの情報を確かめます。方針が脆弱性の修正なら脆弱性の情報も確かめて、上げる必要が無いときや上げ先を決められないときは理由を出して止まります。

上げ先が決まると、CLIは移行の説明を一時フォルダにコピーしてSkills(エージェントに渡す手順書)をそろえます。メジャーの版をまたぐときは、またぐ版ごとの移行の説明が入ります。エージェントには別のGitのworktreeを使うことと、チェックを走らせて結果を確かめることも頼みます。

上げ先の版を選ぶのはエージェントではなくCLIなので、AIが勘で版を選ぶ心配はありません。

方針を指定しなければ脆弱性の修正だけに上げる

方針を何も指定しないと、next upgrade --agent は security の方針で動きます。方針は次の3つです。

  • security:脆弱性の影響がある安定版を、上げられる中で最も近いメジャーの安全な最新の版に上げる
  • latest:npmの latest の安定版まで上げる
  • experimental-future:latest に加えて、Cache Componentsのようにこれから標準になる機能へも移す

前の節の脆弱性の知らせのように修正版が版の系列ごとに出る場合でも、security の方針ならCLIが御社の版から上げる先を選びます。latest や experimental-future を選ぶとメジャーの版をまたぐことがあり、エージェントが直すファイルも増えます。

16.4では next.config の experimental.agentUpgrade も入りました。初期の方針は security で、next dev と next build の途中で脆弱性の修正があると知らせます。この設定は知らせるだけで、版を勝手に上げることはありません。

脆弱性を直したいだけなら方針は security のままにし、latest 以上はメジャーの移行として別に計画してください。

公式も本番での利用をすすめていない

Next.js公式の説明には、この機能は実験的で今後変わる可能性があり本番での利用はすすめないと書かれています。そのため next upgrade --agent は本番のブランチで動かさず、別のworktreeで動かした結果を人が確かめてから本番に出します。

人が見る所は3つです。1つめは package.json とロックファイルの差分で、上げた版が意図した版かを見ます。2つめは next.config の差分です。エージェントは選んだ方針を experimental.agentUpgrade として保存するように頼まれているので、その1行のほかに変わった所が無いかを見ます。3つめはビルドとプレビューでの表示とフォームの送信です。

エージェントの許可の設定にも気をつけます。対話の画面からClaude CodeやCodexを起動すると、許可の確認を省くかどうかを選ぶ画面が表示されることがあります。作業を別のworktreeに分けていても、コマンドを実行する前に確認する設定を残しておくと何をしたかを追えます。Claude Codeに鍵を読ませない設定は.envとサンドボックスの記事で説明しています。

エージェントの作業は差分になって残るので、本番に出す前に人が読める形で受け取るのが安全です。

エージェントに任せる版上げと人が行う版上げ

エージェントに任せるかどうかは、版上げの理由と変わる範囲と確かめる場所で決まります。社内で説明するときは次の表をそのまま使えます。

確かめること

エージェントに任せてよい

人が1つずつ行う

版上げの理由

脆弱性の修正(security)

メジャーの移行やCache Componentsへの移行

変わるファイル

package.jsonとロックファイルとnext.configの1行

ページや部品のファイルが何十も変わる

確かめる場所

Vercelのプレビューなど本番と同じ設定の環境がある

本番に出さないと確かめられない

Gitの状態

変更がコミット済みでworktreeを分けられる

コミットしていない作業が残っている

4つとも左の列なら、版上げはエージェントに任せて人は差分とプレビューだけを見てください。右の列が1つでもあるなら、エージェントの結果を参考にしながら変わったファイルを人が1つずつ確かめます。

ページが数枚のサイトで、自分で版を上げてビルドを確かめられるならエージェントを使わなくて問題ありません。その場合は npm install next@latest を実行して next build が通るかを見るほうが早く終わります。

next upgrade --agentで版上げして確かめる手順

2026年11月時点・Next.js 16.4以降・Gitで管理しているリポジトリ・Vercelのプレビューを使う場合の手順です。公式の説明に沿って、方針は初期の security にします。

  1. 作業の前に今の状態を残します。コミットしていない変更が無いことを git status で確かめ、残っていればコミットしてから進めます。
    git status
    git switch main
    git pull
  2. アプリのフォルダで次のコマンドを実行します。next@canary を使うのは御社のアプリの版が古くても新しい版上げの道具を使うためです。アプリが安定版なら上げ先も安定版になります。
    npx next@canary upgrade --agent
  3. 上げる必要が無いときは、CLIが理由を出して止まります。その場合は今の版に既知の脆弱性の修正が無いということなので、ここで作業は終わりです。
  4. 対話の画面では使うエージェントを選び、別のGitのworktreeで開くかを聞かれたら開く方を選びます。許可の確認を省くかを聞かれたら、確認を残す方を選びます。
  5. エージェントが終わったら、worktreeの差分を読みます。上げた版と next.config の変更を確かめます。
    git diff main -- package.json next.config.ts
    git diff main --stat
  6. worktreeの中でビルドが通るかを確かめます。
    npm ci
    npm run build
  7. 作業用のブランチをプッシュし、Vercelのプレビューで主なページの表示と問い合わせフォームの送信を確かめます。問題が無ければプルリクエストで本番のブランチに入れます。
  8. 版上げの知らせが必要ない場合は next.config の experimental.agentUpgrade を false にします。

うまくいったかは3つで判断します。5で上げた版が意図した版になっていて6のビルドが通り、7のプレビューでフォームの送信まで動けば完了です。git diff main --stat で変わったファイルが思ったより多いなら、表の右の列に当たるのでファイルを1つずつ確かめてください。

やりがちな失敗は、ロックファイルの差分を読まずに入れてしまうことです。package.json の版が変わっていなくても、ロックファイルの中でほかのパッケージの版が変わることがあります。

弊社がAIで作るときに人が必ず見る所

弊社も制作にAIを使いますが、AIに任せた作業は次の2つを守ってから先へ進めています。

  • 秘密の鍵はサーバーの側だけで使う:公開の前に名前が NEXT_PUBLIC_ で始まる環境変数を一覧で見て、画面に出てはいけない鍵が入っていないかを確かめます
  • AIが作ったものは人が確認してから先へ進める:弊社の業務の自動化でも、AIが書いた記事は人が社内の確認用のボードで承認してから公開しています

版上げも同じで、AIに任せる範囲が広がるほど人が見る所を先に決めておくと弊社は考えています。

弊社がやっていること

弊社はClaude CodeやChatGPTなどのAIで作ったサイトの点検と公開を引き受けています。点検ではコードを書き直さずにそのまま読み、直した方がよい所を報告に書きます。WordPressからNext.jsに移したときに何が変わるかは別の記事で紹介しています。

上の表で4つとも左の列なら、版上げはこの記事の手順で御社の中で進められるので弊社に頼む必要はありません。ページが数枚で自分でビルドを確かめられる場合も、弊社の点検は必要ありません。

点検の中身はAIで作ったサイトの引き継ぎと点検のページに、料金は料金の一覧にあります。エージェントの版上げの結果を本番に出してよいか迷う場合は相談の窓口からご連絡ください。初回の30分は無料です。

よくある質問

next upgrade --agentはClaude Code以外でも使えますか

使えます。公式の説明では対話の画面からCodexかClaude Codeを起動でき、ほかのエージェントには作業の指示をコピーして渡せます。

experimental.agentUpgradeを入れると勝手に版が上がりますか

上がりません。この設定はnext devとnext buildの途中で版上げを知らせるだけで、版上げはUpgrade nowを選んだときに始まります。

本番のブランチで直接動かしてはいけませんか

本番のブランチでは動かさないでください。公式はこの機能を実験的で本番での利用はすすめないとしているので、別のworktreeで動かして差分を確かめてから本番に入れます。

Cache Componentsへの移行もエージェントに任せられますか

任せられますが人が1つずつ確かめる側の作業です。experimental-futureの方針は移行の説明とSkillsを渡しますが、ページや部品のファイルが多く変わるので差分を1つずつ読んでください。

RELATED