claude auth status：ログイン状態をコードで確認する方法

自動化スクリプトを回したのに「ログインできていなくて、そのまま止まってしまった」なら困りますよね。作業を始める前に「今ログインできているか？」を先に確認できれば、こうした事故を防げます。その確認を担当するコマンドがclaude auth statusです。

定義（なにかというと）

claude auth statusは、現在のClaude Codeのログイン状態を確認するコマンドです。結果をJSON形式で見せてくれます。

JSONは「JavaScript Object Notation（ジャバスクリプトオブジェクト記法）」の略で、コンピュータ同士でデータをやり取りしやすい決まった形式です。人が読むには少し密ですが、スクリプト（自動でコマンドを実行する小さなプログラム）が結果を読んで判断するにはとても便利な形です。なのでこのコマンドは、自動化作業で「進めてよいか」を点検する用途でよく使われます。

どう使うか（難易度別）

基礎 — 状態を確認する

claude auth status

この一行を入力すると、現在のログイン有無とアカウント情報をJSON形式で見せてくれます。「自分は今ログインできているか？」を素早く確認したいときに使えばOKです。

応用 — 人が読みやすく見る

claude auth status --text

--textオプションを付けると、JSONの代わりに人が読みやすい文字形式で見せてくれます。オプションはコマンドの後ろに付けて動作の仕方を変える追加設定です。JSONが目に入りにくいなら、このオプションを使うのが楽です。

実践事例

自動化スクリプトの先頭にclaude auth statusを入れておけば、ログインできているときだけ次の作業に進むように作れます。ログインできていなければそこで止まって知らせてくれるので、見当違いの状態で作業が進むのを防ぐ安全装置になります。

こんな使い方も

複数の段階で続く自動化作業を作るとき、開始地点に状態点検を一度入れておく習慣をつけると良いです。人が毎回目で確認しなくてもスクリプトが自分で「ログインできているか」見て進むので、夜間バッチ作業や定期実行のように人が見守れない作業で特に頼もしいです。

まとめ

claude auth statusはClaude Codeのログイン状態をJSONで確認するコマンドです。--textオプションを付ければ人が読みやすい形式で見られ、自動化スクリプトの先頭に置けば、ログイン有無を点検する安全装置の役割をします。

基準：Claude Code v2.1.154 (2026.05)