Codex初心者向け更新日

Codex 設定

Codex は OpenAI のコーディングアシスタントです。

先に「環境設定」の章を完了し、Node.js と npm がインストールされていることを確認してください。

設定後、モデル、Provider、権限、セッション、トークン使用量については Codex config.toml 詳細ガイドを参照してください。


Linux / MacOS

ステップ 1: Codex をインストール

npm install -g @openai/codex@latest

ステップ 2: 設定フォルダーを作成

ホームディレクトリ配下に .codex フォルダーを作成します。

mkdir -p ~/.codex

ステップ 3: config.toml を作成

.codex の中に config.toml を作成し、次を貼り付けます:

model_provider = "icodeeasy"
model = "gpt-5.6-sol"
cli_auth_credentials_store = "file"
suppress_unstable_features_warning = true
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
wire_api = "responses"
requires_openai_auth = true

利用中のネットワークで api.icodeeasy.cc が遅い場合は、base_urlhttps://jp.icodeeasy.cc または https://sg.icodeeasy.cc に変更してください。

ステップ 4: ログインして auth.json を生成

API Keys から API Key をコピーし、次のコマンドを実行します。キーを貼り付けて Enter を押してください。入力は表示されず、シェルの起動ファイルにも保存されません。

read -s OPENAI_API_KEY
printf '\n'
printf '%s' "$OPENAI_API_KEY" | codex login --with-api-key
unset OPENAI_API_KEY
codex login status

Codex は認証情報を ~/.codex/auth.json に保存します。このファイルを手動で作成・編集しないでください。config.toml はモデルと Provider、auth.json はログイン認証情報を担当します。両方を現在のユーザーだけが読み書きできるようにします。

chmod 600 ~/.codex/config.toml ~/.codex/auth.json

ステップ 5: Codex を起動

cd your-project-folder
codex

Windows

ステップ 1: Codex をインストール

npm install -g @openai/codex@latest

ステップ 2: 設定フォルダーを作成

ユーザーディレクトリを確認します:

echo $env:USERPROFILE

.codex フォルダーを作成します:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

ステップ 3: config.toml を作成

.codex の中に config.toml を作成し、次を貼り付けます:

model_provider = "icodeeasy"
model = "gpt-5.6-sol"
cli_auth_credentials_store = "file"
suppress_unstable_features_warning = true
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
wire_api = "responses"
requires_openai_auth = true

[features]
elevated_windows_sandbox = true

利用中のネットワークで api.icodeeasy.cc が遅い場合は、base_urlhttps://jp.icodeeasy.cc または https://sg.icodeeasy.cc に変更してください。

ステップ 4: ログインして auth.json を生成

API Keys から API Key をコピーし、次を実行します。

$secureKey = Read-Host "API Key" -AsSecureString
$plainKey = [System.Net.NetworkCredential]::new("", $secureKey).Password
$plainKey | codex login --with-api-key
$plainKey = $null
codex login status

Codex は認証情報を $env:USERPROFILE\.codex\auth.json に保存します。このファイルを手動で編集したり、永続的なユーザー環境変数 OPENAI_API_KEY を設定したりする必要はありません。

ステップ 5: Codex を起動

新しい PowerShell ウィンドウを開き、プロジェクトディレクトリに移動して起動します:

cd your-project-folder
codex

VSCode

先に Codex CLI の設定を完了し、codex login status が成功することを確認してください。VSCode 拡張機能は同じ config.toml と Codex のログインキャッシュを再利用します。

ステップ 1: Codex をインストール Extension

VSCode 拡張機能マーケットプレイスで Codex を検索してインストールします。

ステップ 2: 設定ファイルを開く

Codex VSCode 拡張機能はユーザーディレクトリ配下の .codex/config.toml を再利用します。上の Linux / MacOS または Windows の手順に従って .codex フォルダーと config.toml を作成してください。

ステップ 3: API Key を設定

通常は API Key を再入力する必要はありません。ログインを求められる場合は、VSCode の統合ターミナルで codex login status を実行してから Developer: Reload Window を実行してください。