Codex を社内で使い始めると、情報システム部門から必ず出る質問があります。「開発者の PC には API キーやデータベースのパスワードが入っている。Codex はそれを読めるのか」というものです。

答えは「設定しだい」です。Codex は手元の PC でもクラウドでも、コマンドを実行しファイルを読みながら作業します。何も決めずに使えば、作業に要らない秘密情報まで Codex の手の届く場所に置いたままになります。

この記事では、鍵や環境変数を Codex に触らせないための設定を、手元の PC とクラウドの2つに分けて整理します。製品の動きに関わる内容は、2026年11月4日に OpenAI の公式ドキュメント(Codex security cookbook・Configuration Reference・Cloud environments)で確かめた範囲に絞りました。

結論: 手元の PC では「子プロセスに渡す環境変数を絞る」と「.env や鍵ファイルの読み取りを禁止する」の2つを組み合わせます。前者は既定では働かないので明示して設定し、後者は組織の管理設定で全員にかけます。クラウドでは、外部サービスの鍵はネットワークシークレットに登録し、環境変数には秘密でない値だけを入れます。設定したら、ダミーの秘密ファイルで本当に読めないことを確かめます。

なぜ「鍵の置き場所」を先に決めるのか

秘密情報の漏れ方は1つではありません。Codex の作業では、少なくとも次の4つの経路を考える必要があります。

経路 例 主な対策
環境変数 シェルに設定した AWS_SECRET_ACCESS_KEY がコマンドに引き継がれる 子プロセスに渡す環境変数を絞る
ファイル リポジトリ内の .env・ホームの認証情報フォルダ・鍵ファイル 読み取り禁止の設定
人の入力 プロンプトにパスワードを貼り付ける・ソースにコミットする 社内ルールと教育
外部連携 コネクタや MCP が返した結果に秘密情報が含まれる 接続先と権限の絞り込み

公式の security cookbook でも、ファイルの読み取り禁止は、すでにプロンプトに貼り付けた秘密情報・読めるソースにコミット済みのもの・コネクタが返したもの・モデルが読める記録に書き出されたものは取り除かないと明記されています。(出典: Codex security cookbook)

つまり1つの設定で全部を守ることはできません。この記事で扱うのは表の上2つ(環境変数とファイル)とクラウド環境の登録方法で、残りの2つは社内ルールで補います。ルールの書き方は社内利用ガイドラインの記事を参考にしてください。

手元の PC: 子プロセスに渡す環境変数を絞る

Codex が手元の PC でコマンドを実行するとき、そのコマンドにどの環境変数を引き継ぐかは config.toml の shell_environment_policy で決まります。公式の設定リファレンスに書かれている主な項目は次のとおりです。(出典: Configuration Reference・Advanced Configuration)

項目 意味 法人での考え方
inherit 引き継ぐ環境の出発点。all・core・none から選ぶ core から始めて足りないものだけ足す
ignore_default_excludes 変数名に KEY・SECRET・TOKEN を含むものを自動で外す仕組みを飛ばすかどうか。既定は true(飛ばす=外さない) false にして自動で外す
exclude 名前の型で外す変数を指定する 社内で使う鍵の名前の型を並べる
set 値を明示して渡す 秘密でない設定値だけに使う

ここで一番の注意点は既定値です。ignore_default_excludes は既定で true なので、何もしなければ KEY や TOKEN を含む変数もそのまま引き継がれます。インターネット上の古い解説では既定値が逆に書かれていることがあるため、必ず公式の記載で確かめてください。

公式の説明では、処理の順番は「自動の除外 → 利用者が指定した除外 → set の値 → 含める型の指定(許可リスト)」です。型は大文字小文字を区別せず、* と ? が使えます。許可リストを指定すると、そこに合わない変数はすべて外れます。

security cookbook には、inherit = "core" と ignore_default_excludes = false を組み合わせ、AWS_* や *_TOKEN のような型を外す例が載っています。設定の形は次のようになります。

[shell_environment_policy]
inherit = "core"
ignore_default_excludes = false
exclude = ["AWS_*", "*_TOKEN"]

exclude の書き方には新しい filters の表もあり、公式の説明では古い exclude・include_only の配列も引き続き使えますが、同じ設定の層で両方を混ぜると受け付けられません。社内で配る設定はどちらか一方にそろえてください。

また cookbook では、ログインシェルの初期化に頼っている作業があるため、この変更はまず試験的に入れることが勧められています。いきなり全員に配らず、開発チームの数人で1週間ほど使ってから広げると、「ビルドが通らなくなった」といった問い合わせを先に拾えます。

この設定だけでは足りない理由

cookbook は、環境変数を絞る設定を利用者が変えられる既定値であって強制の境界ではないと位置づけています。認証情報のファイル・認証の補助プログラム・シェルの起動時の設定などへのアクセスは、この設定では防げません。(出典: Codex security cookbook)

そのため、次のファイルの読み取り禁止とあわせて使います。

手元の PC: .env や鍵ファイルの読み取りを禁止する

ファイルの中身を守るのは、権限の設定にある読み取り禁止のルールです。cookbook の「秘密情報を守る」手順では、作業用の権限プロファイルの中で .env ファイル・鍵ファイル・認証情報のフォルダを読み取り禁止にする例が示されています。(出典: Codex security cookbook・Permissions)

法人で大事なのは、どこに書くかです。cookbook では、組織が管理する requirements.toml の deny_read に書くことが勧められています。理由は次のとおりです。

  • 管理設定の読み取り禁止は、許可されたすべての権限プロファイルにかかる
  • 1つのプロファイルの中にだけ書いた禁止は、利用者が別のプロファイルを選ぶと効かない

開発者それぞれの設定に任せると、プロファイルを切り替えた人だけ守られていない状態が生まれます。全員にかけたい禁止は、管理設定にまとめてください。requirements.toml で設定を固定する考え方はセキュリティとガバナンスの記事で解説しています。

cookbook には、次の既知の限界も書かれています。社内の説明資料に入れておくと、後から「聞いていなかった」となるのを防げます。

限界 内容 補い方
Windows のネイティブ環境 管理設定の読み取り禁止は Codex のファイル操作には効くが、それだけではシェルの子プロセスからの読み取りは防げない OS のユーザー分けとファイルのアクセス権もあわせて使う
後から作られたファイル 作業中に新しく作られた、型に合うファイルは、その実行中の禁止リストに足されない 秘密ファイルは作業を始める前に置き場所を決める
既に外に出たもの プロンプトへの貼り付け・コミット済みの鍵・コネクタの返り値・記録への書き出しは対象外 社内ルールと鍵の作り直し

クラウド: 環境変数とネットワークシークレットを使い分ける

Codex のクラウド環境では、設定画面から値を登録します。現在のクラウド環境の公式ドキュメントでは、登録する値の種類として環境変数とネットワークシークレットの2つが説明されています。(出典: Cloud environments)

種類 プログラムから見えるもの 向いている値
環境変数 値そのもの 秘密でない設定値(接続先の名前・機能の切り替えなど)
ネットワークシークレット 代わりの値だけ。許可した HTTPS の宛先(443番ポート)への通信のときにプロキシが本物の値に差し替える 決まった外部サービスに送る API キーやトークン

ネットワークシークレットでは、本物の値がローカルのプロセスやファイルに置かれないと説明されています。差し替えは準備(セットアップ)の段階でもタスクの実行中でも働きます。ページによっては「HTTP secrets」という名前でも書かれていますが、同じ仕組みを指しています。

ここで2つ気をつけることがあります。

  1. ネットワークシークレットを保存すると、その宛先への通信も許可される: 公式ドキュメントでは、シークレットを保存すると対象のドメインへのアクセスも許されると書かれています。鍵の登録は通信の許可でもあると考え、宛先は必要なものだけにしてください
  2. 個人の値は適用範囲を選べる: 個人の保管庫に登録する値は「すべての環境」か「選んだ環境」かを選べ、特定の環境向けの値が全体の既定より優先されます。本番に近い環境の鍵は「選んだ環境」だけに付けるのが安全です

インターネットへの接続の許可は、鍵とは別に設定します。公開インターネットへの接続をすべて許すか・パッケージ管理のドメインを許すか・個別に許すホストを足すかを選べます。許可範囲の決め方はローカル・Worktree・クラウドの使い分けの記事とあわせて検討してください。

旧版のクラウド環境を使っている場合

旧版(Legacy)のクラウド環境では扱いが異なります。公式ドキュメントでは、旧版の環境変数はチャットの間ずっと設定され、シークレットはセットアップのスクリプトでしか使えず、エージェントが作業を始める前に取り除かれると説明されています。また、セットアップのスクリプトはエージェントとは別のシェルで動くため、そこで export した値はエージェントの作業に引き継がれません。(出典: Codex Cloud (Legacy))

旧版から移るときは、「セットアップでだけ使っていた鍵を、新しい環境でどの種類として登録するか」を1つずつ決め直してください。2026年9月以降のクラウド環境の更新は10月のアップデートまとめで紹介しています。

設定したら本当に読めないかを確かめる

設定は書いただけでは効いているか分かりません。cookbook では、害のないダミーのファイル(.env.test や .aws/credentials の形をした中身のないファイル)を置き、Codex のファイル操作とシェルの両方から読めないことを確かめる方法が勧められています。(出典: Codex security cookbook)

社内では次の手順で確かめると、結果を記録に残しやすくなります。

  1. 試験用のリポジトリに、本物の値を含まないダミーの .env.test を置く
  2. ホームの認証情報フォルダの位置にも、ダミーのファイルを置く(本物があるなら試験用の PC を使う)
  3. Codex に「このファイルの中身を表示して」と頼み、ファイル操作で読めないことを確かめる
  4. 同じことをシェルのコマンド(cat など)で頼み、こちらも読めないことを確かめる
  5. 「環境変数の一覧を出して」と頼み、外したはずの名前が出てこないことを確かめる
  6. 結果を OS ごと(Mac・Windows・Linux)に記録し、設定を変えるたびにやり直す

とくに Windows は、上の表のとおりファイル操作とシェルで結果が分かれることがあります。手順3と4を必ず分けて確かめてください。

法人で先に決めておくこと

設定の前に、次の4つを社内で決めておくと、配る設定と説明がぶれません。

  • 鍵の持ち方: 開発者の PC に長く使える鍵を置かない方針にするかどうか。cookbook では、エージェントの認証には独立した仲介の仕組みから、宛先と操作を絞った短い有効期限の認証情報を渡す考え方が紹介されています
  • 禁止するファイルの一覧: .env 系・鍵ファイル・クラウドの認証情報フォルダなど、社内で使っているものを情シスが一覧にする
  • 設定の配り方: 全員にかける禁止は requirements.toml に、環境変数の絞り込みは配布する config.toml に書く
  • 漏れたときの手順: 鍵をプロンプトに貼った・コミットしたと分かったときに、誰に連絡して鍵をどう作り直すか

サンドボックスと承認の設定で「Codex がどこまで自動で動けるか」を決める考え方は、サンドボックスと承認ポリシーの記事にまとめています。秘密情報の設定は、この2つを組み合わせて初めて効きます。

まとめ

Codex に鍵を触らせないためには、手元の PC とクラウドで別々の設定が必要です。手元の PC では、子プロセスに渡す環境変数を shell_environment_policy で絞り(既定では KEY・TOKEN を含む変数も外れない点に注意)、.env や鍵ファイルは組織の管理設定で読み取り禁止にします。クラウドでは、外部サービスの鍵をネットワークシークレットに登録し、環境変数には秘密でない値だけを入れます。そのうえでダミーのファイルで読めないことを確かめ、設定で防げない経路は社内ルールで補います。

この記事の内容は、2026年11月4日時点の OpenAI 公式ドキュメントの記載に基づいています。設定項目の名前や画面の操作は変わることがあるため、使う前に最新の記載をご確認ください。デジライズでは、情報システム部門と一緒に秘密情報の扱い方を決め、配布する設定・社内ルール・確かめ方の手順までを整える Codex の法人導入支援のご相談を承っています。「まず開発チームの数人で試したい」という段階からでもお問い合わせください。