Codex Cloudの通信を確認する

Codex Cloudで「必要なものを取得できない」とき、すべてをログインや権限の問題と考える前に、通信が止まった段階を確認します。クラウド環境の準備中と、エージェントが作業している途中では通信の扱いが違います。

準備段階と作業段階を分ける

公式資料では、セットアップスクリプトは依存関係を導入できるようインターネットへ接続します。一方、エージェントの作業段階は既定で通信がブロックされ、環境単位で必要な接続を設定できます。Codex Cloudの通信設定

インターネットが使える設定でも、外部サービスへログインできるとは限りません。通信の許可と、そのサービスの認証は別です。

各段階で確認してから、次の操作へ進みます。

1. 1段階を特定準備中かエージェント実行中かを調べます。
2. 2接続先を絞る必要なドメインと操作を確認します。
3. 3必要分を再試行結果とログで目的の通信を確かめます。

具体的な依頼と、結果の確かめ方は本文にあります。

最初に段階を特定すれば、関係のない設定を広げずに済みます。

必要な通信を具体的にする

外部の公開資料を読むのか、依存関係を取得するのか、APIへ更新を送るのかを整理します。次は設定変更前に使える依頼例です。

今回失敗した通信を整理してください。まだ設定は変更しないでください。
1. 失敗したのはセットアップ中か、エージェントの実行中か
2. 実行しようとした処理と必要な接続先のドメイン
3. 必要なHTTPメソッドと、読み取り・送信のどちらか
4. エラーから分かる事実と、推測に留まる原因
URLに認証情報や秘密の値がある場合は回答へ載せないでください。

HTTPメソッドは、取得や送信などの操作の種類です。ページを取得するGETと、データを送るPOSTでは目的が違います。

環境ごとに範囲を決める

エージェント通信を有効にする場合、ドメインの許可リストとHTTPメソッドを制限できます。公式資料にはGET・HEAD・OPTIONSへ絞る例があります。必要な処理がPOSTを使うなら、そのままでは通らないため、目的と送る内容を確認します。

「読むだけのメソッドなら何を送ってもよい」という意味ではありません。URLのクエリにも情報を含められるため、どこへ何を渡すかの確認は残ります。

最初からすべてのドメインを許可する前に、一つの必要な取得先と処理へ絞ります。組織で管理されている場合は、自分が変更できる範囲と管理方針を確認してください。

再試行の前後を記録する

1. 元の設定と失敗した処理を控えます。
2. 必要な設定だけを変更します。
3. 同じ処理を再試行して、成功か別のエラーかを確認します。
4. 不要になった一時的な許可は、今回の差分を確認して戻します。

通信が通った後に別の認証エラーが出る場合もあります。それは設定変更が無意味だったということではなく、次の確認箇所が分かった可能性があります。最初のエラーと変わった点を残します。

外部ページは作業指示と区別する

WebページやREADMEには、依頼と無関係な命令が含まれる場合があります。取得した文章を根拠として読むことと、その中の命令を実行することを分けます。意図しない送信や変更を求められたら、元の目的へ戻って判断します。

この記事は公式設定の説明と切り分け例です。クラウド環境の設定変更やネットワーク再試行は実施していません。手元との違いは作業場所の比較、エラーの残し方は状況整理も参照してください。