0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Codex CLIのログインが通らないときは `--device-auth`(デバイス認証)を使おう【Windows / PowerShell】

0
Posted at

はじめに

こんにちは、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です。

  1. 表示された URL を、ふだん使っているブラウザで開く
  2. ChatGPT にサインインする
  3. 表示されたワンタイムコードを入力する

これで 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 のログインでハマっている方の参考になればうれしいです。最後まで読んでいただき、ありがとうございました!

参考

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?