For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション

おすすめ

はじめに

ID と認証

ワークスペースのアクセス、ポリシー、モデル

プラグインとコネクタの制御

利用状況、ガバナンス、コンプライアンス

展開とモデルプロバイダー

API Dashboard
ChatGPT を試す

認証

ChatGPT Web と Codex クライアントのサインイン方法

OpenAI 認証

OpenAI モデルを使用する場合、Codex では次の 2 つの方法でサインインできます：

  • ChatGPT でサインインしてサブスクリプションを利用
  • API キーでサインインして従量課金で利用

ChatGPT デスクトップアプリ、Codex CLI、IDE 拡張機能は、ローカルでの作業で両方のサインイン方法に対応しています。 Codex Cloud を利用するには ChatGPT でのサインインが必要です。

適用される管理者向けの制御機能とデータ処理ポリシーも、サインイン方法によって決まります。

  • ChatGPT でサインインすると、Codex の利用には、ChatGPT ワークスペースの権限、 ロールベースのアクセス制御（RBAC）、および ChatGPT Enterprise の データ保持とデータレジデンシーに関する設定が適用されます。
  • API キーを使用する場合は、代わりに API 組織のデータ保持と データ共有に関する設定が適用されます。

管理対象のワークスペースでは、認証はアクセス制御の一要素にすぎません。 サインインできるユーザーはワークスペースのメンバーシップとプロビジョニングで決まり、 利用できるプロダクトの各画面や機能は、シートとワークスペースのロールによって決まります。 ChatGPT デスクトップアプリ、Codex CLI、IDE 拡張機能でローカル作業を行う場合は、 権限プロファイルによって、エージェントがデバイス上で実行できる操作が制限されます。 これらの制御の計画については、「グループとプロビジョニング」 および「ロールとワークスペースの権限」 を参照してください。

ChatGPT でのサインイン

ChatGPT デスクトップアプリ、Codex CLI、または IDE 拡張機能から ChatGPT でサインインすると、ブラウザウィンドウが開きます。サインイン後、ブラウザから認証情報が Codex に返されます。

ChatGPT デスクトップアプリ

サインアウト状態の画面で「 サインインを続ける」を選択し、 ブラウザでの手続きを完了します。

API キーでのサインイン

ChatGPT デスクトップアプリ、Codex CLI、または IDE 拡張機能には、API キーでもサインインできます。API キーは「OpenAI ダッシュボード」から取得してください。

ChatGPT デスクトップアプリ

サインアウト状態の画面で「 別の方法でサインイン」を選択してキーを入力し、 「 続ける」を選択します。

OpenAI は、API キーの使用料金を標準の API 料金に基づき、OpenAI Platform アカウントを通じて請求します。詳しくは、「API 料金ページ」を参照してください。

API キー認証はローカルの Codex ワークフローに対応していますが、 ChatGPT ワークスペースへのアクセスやクラウドサービスに依存する一部の機能は、制限されるか利用できません。 プランごとの対応状況は、 「機能の提供状況」で比較できます。

Codex CLI および ChatGPT デスクトップアプリの Codex では、API キー認証でも OpenAI が選定した対応プラグインを利用できます。一部のプラグインは、 接続フローで未対応の OAuth 機能を 必要とするため利用できません。詳しくは、「プラグインの使用」を参照してください。

API キーでサインインすると、Codex には ChatGPT プランに含まれるクレジットではなく、 標準の API 料金が適用されます。

CI/CD ジョブなど、プログラムから実行する Codex CLI ワークフローでは API キー認証を使用してください。 信頼できない環境や公開環境に Codex の実行機能を公開しないでください。

認証状態の確認またはサインアウト

プロファイルメニューを開くと、使用中のアカウントまたは API キーの状態を確認できます。 現在の認証情報を消去するには、「ログアウト 」を選択します。

エンタープライズ自動化での Codex アクセストークンの使用

ChatGPT Enterprise ワークスペースでは、管理者がアクセストークンの権限を付与できます。 権限を付与されたメンバーは、信頼できる非対話型の Codex ローカルワークフローで使用する Codex アクセストークンを作成できます。ブラウザでサインインせずに、ChatGPT ワークスペースへのアクセス、 ChatGPT で管理される Codex の利用資格、またはエンタープライズワークスペースの管理機能を 自動化で利用する必要がある場合は、アクセストークンを使用してください。

アクセストークンは、信頼できるスクリプト、スケジューラー、プライベート CI ランナーでの使用を目的としています。 一般的な OpenAI API の呼び出しには、引き続き Platform API キーを使用してください。

セットアップ手順、権限、ローテーション、失効に関するガイダンスについては、 「アクセストークン」を参照してください。

クラウドプラットフォーム、CI システム、またはクラスターがすでに有効期間の短い ワークロードトークンを発行している場合は、OpenAI の認証情報を保存する代わりに、 「ワークロード ID フェデレーション」 を使用してください。

Codex Cloud アカウントの保護

Codex Cloud はコードベースを直接操作するため、他の多くの ChatGPT 機能よりも強固なセキュリティが必要です。多要素認証（MFA）を有効にしてください。

ソーシャルログインプロバイダー（Google、Microsoft、Apple）を使用する場合、ChatGPT アカウントで MFA を有効にする必要はありませんが、ソーシャルログインプロバイダー側で設定できます。

セットアップ手順については、以下を参照してください：

シングルサインオン（SSO）で ChatGPT にアクセスする場合は、組織の SSO 管理者がすべてのユーザーに MFA の利用を義務付けることが推奨されます。

メールアドレスとパスワードでログインする場合は、Codex Cloud にアクセスする前に、アカウントで MFA を設定する必要があります。

アカウントが複数のログイン方法に対応しており、その一つがメールアドレスとパスワードによるログインである場合は、別の方法でサインインするときでも、Codex にアクセスする前に MFA を設定する必要があります。

ログイン情報のキャッシュ

ChatGPT または API キーを使用して ChatGPT デスクトップアプリ、Codex CLI、または IDE 拡張機能にサインインすると、ログイン情報がキャッシュされ、再利用されます。CLI と拡張機能は同じログイン情報のキャッシュを共有します。どちらかでログアウトすると、次回 CLI または拡張機能を起動したときに、再度サインインする必要があります。

Codex は、ログイン情報をローカルの平文ファイル ~/.codex/auth.json または OS 固有の認証情報ストアにキャッシュします。

ChatGPT でサインインしたセッションでは、Codex が使用中のトークンを期限切れになる前に自動更新するため、通常、アクティブなセッションはブラウザで再度ログインしなくても継続します。

認証情報の保存

cli_auth_credentials_store を使用して、Codex CLI がキャッシュした認証情報の保存先を制御します：

# file | keyring | auto
cli_auth_credentials_store = "keyring"
  • file では、認証情報を auth.json に保存します。保存先は CODEX_HOME 配下です（デフォルトは ~/.codex）。
  • keyring では、オペレーティングシステムの認証情報ストアに認証情報を保存します。
  • auto では、利用できる場合は OS の認証情報ストアを使用し、利用できない場合は auth.json にフォールバックします。

config.toml の完全なスキーマについては、 構成リファレンスを参照してください。

ファイルベースの保存を使用する場合、~/.codex/auth.json はアクセストークンを含むため、パスワードと同様に扱ってください。 コミットしたりチケットに貼り付けたりせず、 チャットでも共有しないでください。

ログイン方法またはワークスペースの指定の必須化

管理対象の環境では、管理者がユーザーに許可する認証方法を制限できます：

# Only allow ChatGPT login or only allow API key login.
forced_login_method = "chatgpt" # or "api"

# When using ChatGPT login, restrict users to a specific workspace.
forced_chatgpt_workspace_id = "00000000-0000-0000-0000-000000000000"

使用中の認証情報が設定済みの制限に一致しない場合、Codex はユーザーをログアウトさせて終了します。

これらの設定は、通常、ユーザーごとのセットアップではなく、管理対象の設定を通じて適用されます。「管理対象の設定」を参照してください。

代替モデルプロバイダー

構成ファイルでカスタムモデルプロバイダーを定義する場合は、次のいずれかの認証方法を選択できます：

  • OpenAI 認証：OpenAI 認証を使用するには、requires_openai_auth = true を設定します。その後、ChatGPT または API キーでサインインできます。この方法は、LLM プロキシサーバー経由で OpenAI モデルにアクセスする場合に便利です。requires_openai_auth = true の場合、Codex は env_key を無視します。
  • 環境変数による認証：env_key = "<ENV_VARIABLE_NAME>" を設定すると、<ENV_VARIABLE_NAME> という名前のローカル環境変数に格納されたプロバイダー固有の API キーを使用します。
  • 認証なし：requires_openai_auth を設定せず（または false に設定し）、かつ env_key も設定しない場合、Codex はプロバイダーに認証が不要であると見なします。この方法はローカルモデルに便利です。