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

# Codex CLI

> OpenAI Codex CLI에서 vox.ai Plugin을 설치하세요.

Codex CLI에서 vox.ai Plugin을 설치하면 도구와 에이전트 설계 스킬을 함께 사용할 수 있습니다.

<Note>
  Codex CLI 와 [Codex App](/docs/ai/codex-app) 은 동일한 `~/.codex/` 설정을 공유합니다. 한쪽에서 vox-ai 를 이미 설치했다면 다른 쪽에서는 별도 설치 없이 바로 사용할 수 있습니다.
</Note>

## Plugin 설치

<Steps>
  <Step title="install 스크립트 실행">
    터미널(셸)에서 아래 한 줄을 실행하면 vox.ai 마켓플레이스가 Codex 에 등록됩니다.

    ```bash theme={null}
    bash <(curl -fsSL https://raw.githubusercontent.com/vox-public/vox-skills/main/install.sh) codex
    ```

    <Accordion title="install.sh 없이 직접 실행">
      내부적으로 아래 한 줄을 실행하는 것과 같습니다.

      ```bash theme={null}
      codex plugin marketplace add vox-public/vox-skills
      ```
    </Accordion>
  </Step>

  <Step title="Plugin 설치">
    `codex` 를 실행한 뒤 `/plugin` 슬래시 명령으로 plugin 목록을 열고 `vox-ai` 를 선택해 **Install plugin** 하세요.
  </Step>

  <Step title="Codex 재시작">
    설치 후 codex-cli 를 완전히 종료하고 다시 실행하세요. 재시작해야 플러그인의 스킬과 MCP 도구가 새 세션에 로드됩니다.
  </Step>

  <Step title="로그인">
    처음 vox MCP 도구를 호출할 때 브라우저에서 vox.ai 로그인 창이 열립니다. 로그인을 완료하면 도구가 활성화됩니다.
  </Step>
</Steps>

## 시작하기

설치와 인증이 끝나면 아래 명령을 실행하세요. 에이전트 생성부터 첫 통화까지 온보딩 과정을 안내합니다.

```
$vox-ai:vox-onboarding
```

## 연결 확인

새 대화에서 "vox.ai 에이전트 목록을 보여줘"라고 요청하세요. 에이전트 목록이 반환되면 연결 완료입니다.

<Note>
  도구가 응답하지 않으면 `codex plugin marketplace add` 명령을 다시 실행했는지, 설치 후 codex-cli 를 재시작했는지 확인하세요.
</Note>

## 관련 문서

* [Codex App](/docs/ai/codex-app) — 데스크톱 앱에서 GUI로 연동
* [Claude Code](/docs/ai/claude-code) — CLI에서 Plugin으로 연동
* [Claude Cowork](/docs/ai/claude-cowork) — Cowork 앱에서 Plugin으로 연동

***

<Accordion title="연관 검색어">
  Codex CLI, OpenAI Codex CLI, Codex Plugin, vox-skills, codex marketplace, codex plugin install
</Accordion>