はじめに
こんにちは、ZEN大学2年の松延(@koheip)です。AIエンジニアを目指して、日々いろいろなAIツールを触っています。
先日、Windows環境で OpenAI の Codex CLI にログインしようとしたところ、codex login がなかなか通らずにハマってしまいました。最終的には デバイス認証(codex login --device-auth) を使うことで解決できたので、同じところでつまずいた方のために手順とコツをまとめます。
特に「エージェントやスクリプトなど、別のプロセスから Codex CLI のログインを実行したい」という方には参考になると思います。
動作確認環境:Windows / PowerShell(筆者の環境での体験ベースです)
症状
codex login を実行すると、通常はブラウザが開いて ChatGPT アカウントでサインインする流れになります。
ところが、エージェントや自動化スクリプトなど 別のプロセスから codex login を起動した ところ、ブラウザ側でサインインしても CLI 側にうまく戻ってこず、ログインがキャンセル扱いになってしまいました。何度やり直しても同じ結果でした。
原因
公式ドキュメントによると、codex login のブラウザログインは、サインイン後に localhost のコールバック(デフォルトは localhost:1455)でトークンを CLI に受け渡す仕組みになっています。
公式ドキュメントでも、次のような場合はブラウザベースのログインがうまくいかないことがあると説明されています。
- リモート環境やヘッドレス環境で CLI を実行している
- ローカルのネットワーク設定が localhost のコールバックをブロックしている
私のケースでは、別プロセスから起動したことで、このブラウザ → localhost へのコールバックを待つ流れが正しく完了せず、キャンセル扱いになっていたようです(ここは私の環境での観察です)。
解決策:--device-auth でデバイス認証する
公式ドキュメントでは、こうした状況では デバイスコード認証(ベータ) を使うことが推奨されています。
codex login --device-auth
実行すると、ターミナルに URL とワンタイムコード が表示されます。あとは次の手順でOKです。
- 表示された URL を、ふだん使っているブラウザで開く
- ChatGPT にサインインする
- 表示されたワンタイムコードを入力する
これで CLI 側のログインが完了します。localhost のコールバックに依存しないので、私の環境ではこれであっさり通りました。最後に状態を確認しておきましょう。
codex login status
公式ドキュメントによると、デバイスコードログインは事前に ChatGPT のセキュリティ設定(個人アカウントの場合)または ワークスペースの権限設定(ワークスペース管理者)で有効化しておく必要があります。うまくいかない場合はまずここを確認してください。
自動化から使うコツ
codex login --device-auth は、ブラウザで認証が完了するまで コマンドが待ち状態(ブロック) になります。エージェントやスクリプトから実行すると、そこで処理が止まってしまい、肝心のコードを読み取れません。
そこで私は、PowerShell の Start-Process で バックグラウンド起動 して、出力をログファイルにリダイレクトし、そのログから URL とコードを読み取るようにしました。
# ログの保存先
$logDir = Join-Path $env:TEMP 'codex-login'
New-Item -ItemType Directory -Force -Path $logDir | Out-Null
$outLog = Join-Path $logDir 'stdout.log'
$errLog = Join-Path $logDir 'stderr.log'
# npm で入れた場合の codex.ps1 ではなく、実行ファイル(codex.cmd / codex.exe)を取得
$codex = (Get-Command codex -CommandType Application | Select-Object -First 1).Source
# バックグラウンドで起動(stdout と stderr は別ファイルにする必要があります)
$proc = Start-Process -FilePath $codex `
-ArgumentList 'login', '--device-auth' `
-RedirectStandardOutput $outLog `
-RedirectStandardError $errLog `
-NoNewWindow -PassThru
# URL とコードがログに出るまで最大2分待つ
$deadline = (Get-Date).AddMinutes(2)
$found = $null
while (-not $found -and (Get-Date) -lt $deadline -and -not $proc.HasExited) {
Start-Sleep -Seconds 1
$found = Get-Content -Path $outLog, $errLog -Encoding UTF8 -ErrorAction SilentlyContinue |
ForEach-Object { $_ -replace '\x1b\[[0-9;]*[A-Za-z]', '' } | # 色付け用のエスケープシーケンスを除去
Select-String -Pattern 'https://\S+', '\b[A-Z0-9]{4,}-[A-Z0-9]{4,}\b'
}
$found | ForEach-Object { $_.Line }
ポイントをまとめます。
-
-RedirectStandardOutputと-RedirectStandardErrorには 別々のファイル を指定します(同じファイルを指定するとエラーになります)。 -
-NoNewWindowは現在のコンソールで動かすオプションです。ウィンドウを出したくない場合は代わりに-WindowStyle Hiddenを使います(この2つは同時に指定できません)。 - コードが stdout / stderr のどちらに出るかはバージョンによって変わるかもしれないので、両方のログを見ています。コードの形式も変わる可能性があるため、
Select-Stringのパターンは実際のログに合わせて調整してください。 - 人間が見守るだけなら、
Get-Content $outLog -Wait -Encoding UTF8でログを追いかけるのも手軽です(Ctrl + Cで抜けます)。
ブラウザで認証を済ませたら、プロセスの終了を待って状態を確認し、ログは削除しておきましょう。
$proc.WaitForExit()
codex login status
Remove-Item -Path $outLog, $errLog -ErrorAction SilentlyContinue
ワンタイムコードや、ログイン後に作られる認証情報(~/.codex/auth.json など)は パスワードと同じ扱い です。ログやスクリーンショットをそのまま SNS や Issue に貼らないよう注意してください。
おまけ:日本語の文字化け対策
Windows では、UTF-8 を設定していないと日本語の出力が文字化けすることがあります。私は次の設定をしておくと安定しました。
chcp 65001 # コードページを UTF-8 に
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8 # コンソール出力を UTF-8 に
$env:PYTHONIOENCODING = 'utf-8' # Python スクリプトを挟む場合
まとめ
-
codex loginは localhost(デフォルトlocalhost:1455)へのコールバックを待つため、別プロセスからの起動などでは通らないことがある - そんなときは
codex login --device-authで、URL とワンタイムコードを使ってふだんのブラウザから認証すればOK - 自動化する場合は
Start-Processでバックグラウンド起動し、ログからコードを読み取ると止まらずに済む
同じように Codex CLI のログインでハマっている方の参考になればうれしいです。最後まで読んでいただき、ありがとうございました!