> ## 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를 통해 제공되는 모델을 사용하세요.

## 코덱스 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. **선택 도구**에서 **Codex**를 선택합니다.

    <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="Claude Code와 Codex 간 전환을 위한 Agent CLI Switch 도구 선택 화면입니다." style={{ borderRadius: '0.5rem' }} width="1354" height="824" data-path="images/coding-plan/vibe-coding/select-tool.png" />
    </Frame>

    4. **Codex edit config**에 다음을 입력합니다.
       `API URL`: `https://maas.apigo.ai/v1`
       `API Key`: ApiGo 키
    5. 구성 저장 프롬프트가 표시되면 구성을 즉시 적용하도록 선택합니다.

    그런 다음 `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>