> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# コーデックス CLI

> AI コーディングには Codex CLI の ApiGo を通じて提供されるモデルを使用します。

## Codex CLI をインストールする

`npm` を使用して Codex CLI をグローバルにインストールします。

```bash theme={null}
# Version 0.57.0 is recommended
npm i -g @openai/codex@0.57.0
```

## ApiGo APIの構成

> **重要: 使用前に OpenAI 環境変数をクリアしてください**
>
> 構成する前に、次の OpenAI 関連の環境変数をクリアして、ApiGo 設定をオーバーライドしないようにします。
>
> * `OPENAI_BASE_URL`
> * `OPENAI_API_KEY`

## 統合方法を選択してください

<Tabs>
  <Tab title="@apigo/vibe-coding">
    `@apigo/vibe-coding` は、対話型ターミナル ツール **Agent CLI Switch** に対応します。このフローは、Codex 構成を直接書き込んで切り替えます。

    スクリーンショットに示されているフローに従います。

    1. **エージェント CLI スイッチ v0.1.0** を開きます。
    2. **メイン メニュー**で、**ツールの構成**を選択します。

    <Frame>
      <img src="https://mintcdn.com/apigo/ooezceiFlVzP_oNP/images/coding-plan/vibe-coding/main-menu.png?fit=max&auto=format&n=ooezceiFlVzP_oNP&q=85&s=43f9a32685ab9f5dfa59217798a10ae0" alt="[構成ツール] が選択されたエージェント CLI スイッチのメイン メニュー。" style={{ borderRadius: '0.5rem' }} width="1238" height="956" data-path="images/coding-plan/vibe-coding/main-menu.png" />
    </Frame>

    3. **ツールの選択**で、**コーデックス**を選択します。

    <Frame>
      <img src="https://mintcdn.com/apigo/ooezceiFlVzP_oNP/images/coding-plan/vibe-coding/select-tool.png?fit=max&auto=format&n=ooezceiFlVzP_oNP&q=85&s=d53ff51f4047b809ce1482fec80b7ea1" alt="Agent CLI の Claude Code と Codex を切り替えるためのツール選択画面です。" style={{ borderRadius: '0.5rem' }} width="1354" height="824" data-path="images/coding-plan/vibe-coding/select-tool.png" />
    </Frame>

    4. **Codex 編集設定** に次のように入力します。
       `API URL`: `https://maas.apigo.ai/v1`
       `API Key`: ApiGo キー
    5. config-saved プロンプトが表示されたら、構成をすぐに適用することを選択します。

    その後、`codex` を直接実行してください。使用前に [モデルカタログ](https://www.apigo.ai/models) で、Token Plan で現在サポートされているモデル ID を確認してから選択してください。
  </Tab>

  <Tab title="手動構成 (現在)">
    1. `.codex/config.toml` で Codex の設定ファイルを編集し、以下を追加します。

    ```toml theme={null}
    [model_providers.apigo]
    name = "Chat Completions API"
    base_url = "https://maas.apigo.ai/v1"
    env_key = "APIGO_API_KEY"
    wire_api = "chat"
    requires_openai_auth = false
    request_max_retries = 4
    stream_max_retries = 10
    stream_idle_timeout_ms = 300000

    [profiles.apigo]
    model = "your-model-id"
    model_provider = "apigo"
    ```

    2. `APIGO_API_KEY` をプラットフォーム キーに設定し、`your-model-id` を [モデルカタログ](https://www.apigo.ai/models) にある現在サポート中のモデル ID に置き換えます。

    3. 構成されたプロファイルを使用して Codex CLI を起動します。

    ```bash theme={null}
    codex --profile apigo
    ```
  </Tab>
</Tabs>
