Codex 利用ガイド

推奨フローは、まず自分の Codex アカウントで認証ログインし、Codex のプラグイン、MCP、Agent 機能を利用可能な状態に保つことです。そのうえで Magick API の token モードを設定し、モデルリクエストを Magick API に転送します。Codex CLI とデスクトップ版は同じローカル設定を共有します。

1. Codex CLI のインストールとログイン

Codex CLI をまだインストールしていない場合は、先にインストールします：

npm i -g @openai/codex

Codex を起動します：

codex

初回起動時に Codex アカウントの認証ログインが案内されます。プラグインやローカルツール機能を維持しやすくするため、Magick API の token モードを設定する前にこの手順を完了してください。

2. Magick API token モードの設定

Codex は OpenAI 互換プロトコルをサポートしているため、環境変数でモデルリクエストを Magick API に向けることができます。

まず API Key 管理ページ で Magick API Key を取得します。

macOS/Linux

現在のターミナルだけで一時的に有効にする場合：

export OPENAI_API_KEY="sk-your magickapi key"
export OPENAI_BASE_URL="https://api.magickapi.com/v1"

永続化する場合は、~/.zshrc または ~/.bashrc に書き込みます：

echo 'export OPENAI_API_KEY="sk-your magickapi key"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.magickapi.com/v1"' >> ~/.zshrc
source ~/.zshrc

Bash を使用している場合は、上記の ~/.zshrc を ~/.bashrc に置き換えてください。

Windows PowerShell

setx OPENAI_API_KEY "sk-your magickapi key"
setx OPENAI_BASE_URL "https://api.magickapi.com/v1"

setx 実行後は、ターミナルを開き直してから Codex を起動してください。

3. Codex プラグインを利用可能に保つ

API Key やサードパーティの OpenAI 互換 base URL を使用すると、一部の Codex バージョンでは GitHub、Chrome 制御、Browser ツール、Agent 関連ツールなどのプラグイン機能が非表示または無効になる場合があります。Codex 設定ファイルでプラグインを明示的に有効化できます。

設定ファイルのパス：

• macOS/Linux：~/.codex/config.toml
• Windows：%userprofile%\.codex\config.toml

ファイルの末尾に以下を追加します：

[plugins."github@openai-curated"]
enabled = true

[plugins."chrome@openai-bundled"]
enabled = true

[plugins."browser@openai-bundled"]
enabled = true

他のプラグインを使用している場合は、プラグイン名ごとに同じ形式で追加できます。現在の Codex バージョンがグローバルなプラグインスイッチをサポートしている場合は、次も追加できます：

[plugins]
enabled = true

設定ファイルに MCP や他のプラグイン設定がすでにある場合は、既存の内容を残したまま、上記の有効化項目だけを追記してください。

4. 再起動と確認

設定を保存したら Codex を再起動します：

codex restart

現在の Codex セッションを終了して、次を再実行してもかまいません：

codex

Codex の対話モードに入ったら、次を入力します：

/plugins

GitHub、Chrome、Browser、MCP、Agent 関連プラグインが引き続き利用可能であることを確認します。GPT モデルを呼び出すとき、Codex は OPENAI_API_KEY と OPENAI_BASE_URL を読み取り、https://api.magickapi.com/v1 経由で Magick API にリクエストを送信します。

代替：Codex provider 設定に書き込む

環境変数に依存したくない場合は、Magick API を Codex の provider 設定に書き込むこともできます。

設定ファイルのパス：

• macOS/Linux：~/.codex/config.toml
• Windows：%userprofile%\.codex\config.toml

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.magickapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

次に auth ファイルへ API Key を書き込みます。

auth ファイルのパス：

• macOS/Linux：~/.codex/auth.json
• Windows：%userprofile%\.codex\auth.json

{
  "OPENAI_API_KEY": "バックエンドで生成されたキー"
}

説明

• OPENAI_API_KEY には、Magick API のバックエンドで生成されたキーを入力してください
• OPENAI_BASE_URL または provider の base_url は必ず https://api.magickapi.com/v1 に設定してください
• token モードはモデルリクエストを Magick API に転送するためのものです。Codex アカウント認証ログインは、Codex 自体の機能、プラグイン、ツール体験を維持するために使用します
• 現在のドキュメントでは model と review_model の両方に gpt-5.5 を使用していますが、【モデル一覧】でサポートされているモデルに自由に切り替えることができます