環境変数

CLAUDE_CODE_OAUTH_TOKEN

Claude.ai 認証用の OAuth アクセストークンを設定します(SDK や自動化環境において /login の代わりに使用)。

使い方・用途

  • ブラウザログインが利用できない CI/CD パイプラインや自動化スクリプトでの認証に使用します。
  • claude setup-token で生成した長期トークンを指定することで、キーチェーンの資格情報よりも優先して認証を適用できます。
英語原文(公式ドキュメントより)

OAuth access token for Claude.ai authentication. Alternative to /login for SDK and automated environments. Takes precedence over keychain-stored credentials. Generate one with claude setup-token

関連する変更履歴

v2.1.118 (1件)

Fixed
CLAUDE_CODE_OAUTH_TOKEN で起動したセッションで /login が機能しない問題を修正
英語原文を表示
Fixed /login having no effect in a session launched with CLAUDE_CODE_OAUTH_TOKEN — the env token is now cleared so disk credentials take effect

変更前

環境変数でトークンを渡して起動すると、その後の /login コマンドが無視され、ディスク上の資格情報に切り替えることができませんでした。

変更後

/login 実行時に環境変数のトークンが適切にクリアされ、永続的な資格情報を優先して使用できるようになりました。

ユーザーへの恩恵

一時的なトークンと常設のログインアカウントを状況に合わせて柔軟に使い分けられます。

v2.1.117 (1件)

Fixed
環境変数 CLAUDE_CODE_OAUTH_TOKEN を使用して起動した際、トークンの期限が切れると /login コマンドが効かなくなる問題を修正しました
英語原文を表示
Fixed /login having no effect when launched with CLAUDE_CODE_OAUTH_TOKEN env var and that token expires

変更前

自動化された環境などでトークンを渡している際、そのトークンが無効になると通常のログインコマンドでも復旧できなくなるケースがありました。

変更後

期限切れのトークンが存在しても、/login による手動ログインや再認証が正しく受け付けられるようになります。

ユーザーへの恩恵

CI/CD や特殊な認証環境でのトラブルからの復旧が迅速に行えるようになります。