Codex CLI

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

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

Plugin 설치

install 스크립트 실행

터미널(셸)에서 아래 한 줄을 실행하면 vox.ai 마켓플레이스가 Codex 에 등록됩니다.

bash <(curl -fsSL https://raw.githubusercontent.com/vox-public/vox-skills/main/install.sh) codex

install.sh 없이 직접 실행

내부적으로 아래 한 줄을 실행하는 것과 같습니다.

codex plugin marketplace add vox-public/vox-skills

Plugin 설치

codex 를 실행한 뒤 /plugin 슬래시 명령으로 plugin 목록을 열고 vox-ai 를 선택해 Install plugin 하세요.

Codex 재시작

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

로그인

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

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

$vox-ai:vox-onboarding

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

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