環境変数

CLAUDE_CODE_OAUTH_TOKEN

claude.ai 認証用の OAuth アクセストークン。SDK や自動化された環境で /login の代わりに使える。キーチェーンに保存された資格情報より優先される。claude setup-token で生成できる。/login を実行しない限り、Claude Code はセッション全体で設定したトークンを使用する。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動する

使い方・用途

  • CI パイプラインやスクリプトなどブラウザによる対話ログインが使えない環境で Claude Code を認証するために使う。
  • claude setup-token で生成した有効期限 1 年の長期トークンを環境変数として渡し、ヘッドレスな自動実行環境でログインを省略する。
  • GitHub Action などで Claude Code を動かす際、サブスクリプションのトークンをリポジトリシークレットとして認証に使う。
英語原文(公式ドキュメントより)

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. Unless you run /login, Claude Code uses the token you set for the whole session. To replace an expired token, generate a new one and restart

関連する変更履歴

v2.1.234(1件)

Fixed
CLAUDE_CODE_OAUTH_TOKEN が設定された状態で /login を実行した後、期限切れトークンのリマインダーが Claude の自動再開ターンに漏れる問題を修正した。リマインダーはあなたにのみ表示される。
英語原文を表示
Fixed: after /login while CLAUDE_CODE_OAUTH_TOKEN is set, the stale-token reminder no longer leaks into Claude's automatically resumed turn — it now appears only to you

v2.1.229(1件)

Updated
/login コマンドによるログインが成功した直後にも、CLAUDE_CODE_OAUTH_TOKEN による環境変数上書きの警告を再度表示するようにアップデートしました。
英語原文を表示
Updated /login to repeat the CLAUDE_CODE_OAUTH_TOKEN override warning after a successful login

変更後

別のアカウントに切り替えたつもりで、実際には古いトークンを使い続けて接続エラーになるトラブルを未然に回避できます。

関連ドキュメント

v2.1.225(1件)

Fixed
長期有効なCLAUDE_CODE_OAUTH_TOKENを保存されたログインの一時的なトークンで置き換える際に発生し、再起動するまでヘッドレスセッションを破損させていた一時的な401エラーの問題を修正しました。
英語原文を表示
Fixed a transient 401 replacing a long-lived CLAUDE_CODE_OAUTH_TOKEN with a stored login's short-lived token, breaking headless sessions until restart

変更後

自動化スクリプトやCIパイプラインの実行中に認証エラーで処理が突然停止し、手動で再起動を余儀なくされる事態を防ぐことができます。

関連ドキュメント

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

変更後

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

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

変更後

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