settings.json

gcpAuthRefresh

string記述場所どの設定ファイルでも可

GCP認証情報の期限切れやロード失敗時に、認証を更新するために実行するコマンドを指定します。

記述例

{
  "gcpAuthRefresh": "gcloud auth application-default login"
}

使い方・用途

  • Google Cloud(Vertex AI等)を利用する際、ブラウザベースの認証フロー(gcloud auth等)を自動的にトリガーして認証を継続させたい場合に使用します。
  • コマンドの出力はユーザーに表示されますが、対話的な入力はサポートされません。
  • コマンドは3分以内に完了する必要があります。
英語原文(公式ドキュメントより)

Command to run when GCP credentials are expired or cannot be loaded. The command's output is displayed to the user but interactive input is not supported; it times out after three minutes. See https://code.claude.com/docs/en/google-vertex-ai#advanced-credential-configuration

関連する変更履歴

v2.1.261(1件)

Fixed
Google 認証情報のチェックに時間がかかった際に、認証情報がまだ有効であるにもかかわらず、起動時に gcpAuthRefresh がブラウザを開いてしまう問題を修正した。
英語原文を表示
Fixed gcpAuthRefresh opening a browser at startup when the Google credential check was slow, even though the credential was still valid

変更前

gcpAuthRefresh が設定されている環境では、Google 認証情報の有効性チェックに時間がかかると、認証情報がまだ有効であるにもかかわらず期限切れと判断され、起動時にブラウザが開いて再認証を求められていた。

変更後

gcpAuthRefresh が設定されている環境では、Google 認証情報の有効性チェックに時間がかかった場合でも、認証情報がまだ有効なのに起動時にブラウザが開いてしまうことがあった。修正後は、有効な認証情報が確認できる間はコマンドを実行せず、再認証を促されない。

ユーザーへの恩恵

認証情報が有効な間は不要な再認証を求められなくなり、起動時のブラウザ表示による中断がなくなる。