しらべベース / 全サイトを探すAI開発ツールしらべの条件検索・比較保存範囲・台帳

GitHub CLI の期限付きトークンとは?opt-in手順と注意点を解説(2026年10月21日)

・ AI開発ツール速報編集部(AI 執筆)

AI開発ツールアップデート料金改定GitHub CLIセキュリティ

GitHub CLI v2.103.0 以降で、期限付きで自動更新される OAuth トークンがパブリックプレビューになりました(2026 年 10 月 21 日発表)。opt-in 手順、スクリプト利用時の注意点、GHES の対応状況を一次情報で解説します。

GitHub CLI の期限付きトークンとは?opt-in手順と注意点を解説(2026年10月21日)

結論から言うと、GitHub CLI(v2.103.0 以降)で期限付きで自動更新される OAuth トークンがパブリックプレビューになりました(GitHub Changelog「GitHub CLI: Opt in to expiring, auto-refreshing OAuth tokens」、2026 年 10 月 21 日)。opt-in すると gh は期限付きアクセストークンとローテーションするリフレッシュトークンを保存し、必要に応じて自動更新します。リークされたアクセストークンは無期限有効ではなく、数時間以内に使えなくなります。

何が変わるかと対象環境

出典: GitHub Changelog「GitHub CLI: Opt in to expiring, auto-refreshing OAuth tokens」(2026年10月21日発表・2026年10月23日取得)

期限付き・自動更新の OAuth 認証情報がパブリックプレビューで利用可能になりました(GitHub Changelog、2026 年 10 月 21 日)。github.com と ghe.com では即時対応、GitHub Enterprise Server は GHES 3.23 以降です。それ以前の GHES やサーバーが対応していない場合は、従来どおりの無期限トークンへフォールバックします。opt-in しなければ既存のサインインや手動トークンは従来どおり動作し、将来的には新規サインインのデフォルト化が計画されています。

opt-in の手順

ログイン時に gh auth login --expiring を実行するか、毎回フラグを付けたくない場合は gh config set expiring_credentials enabled で設定します(GitHub Changelog、2026 年 10 月 21 日)。アクセストークンの状態と有効期限は gh auth status で確認できます。git HTTPS 利用時は gh auth setup-git でクレデンシャルヘルパーを設定し、git 2.46 以降へのアップグレードが強く推奨されています(古い git ではトークンが期限を超えてキャッシュされるため)。

スクリプト利用の注意点

gh auth token の結果をスクリプトなどに保存・コピーすると、最終的に期限切れトークンを掴むことになります(GitHub Changelog、2026 年 10 月 21 日)。トークンを外部で使う場合は毎回 gh auth token で新しく読み取ります。長寿命トークンが必要なワークフローは、当面 opt-in を見送るのが案内のとおりです。

よくある質問

Q. opt-in しないと何か変わる?

変わりません。opt-in しなければ既存のサインインや手動トークンは従来どおり動作します(GitHub Changelog、2026 年 10 月 21 日)。新規サインインのデフォルト化は将来の計画として案内されています。

Q. どのバージョンから使える?

GitHub CLI v2.103.0 以降です(GitHub Changelog、2026 年 10 月 21 日)。GitHub Enterprise Server は GHES 3.23 以降、それより古いサーバーでは無期限トークンにフォールバックします。

Q. トークンはどのくらいで失効する?

アクセストークンは期限付きで、必要に応じて gh が自動更新します(GitHub Changelog、2026 年 10 月 21 日)。リークされたトークンは数時間以内に使えなくなります。有効期限は gh auth status で確認できます。

この記事で解説した内容について、導入や運用の設計で相談したいことがあればお問い合わせ(/contact)からどうぞ。

関連ガイド

この記事は AI が一次ソースを読んで執筆しました。数値と日付は出典に記した公式情報の執筆時点の値です。誤りを見つけたら訂正の窓口へお知らせください。確認のうえ本文を直し、訂正履歴に残します。編集方針