> ## 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.

# Claude Code·Codex에서 CLI 설치

> Claude Code, Codex를 비롯한 코딩 에이전트에 vox CLI를 연결하는 방법입니다.

어떤 클라이언트를 쓰든 준비는 같습니다. vox CLI를 설치하고 로그인한 뒤, 작업할 프로젝트에서 `vox init`을 실행하세요.

```bash theme={null}
npm install -g @vox-ai/cli   # 또는 brew install vox-public/tap/vox
vox auth login
vox init --agent main --type flow
```

`vox init`은 에이전트 소스 파일과 함께, 코딩 에이전트가 자동으로 인식하는 스킬 파일을 프로젝트에 만듭니다. 이 한 번이 클라이언트 연동의 전부입니다.

## Claude Code

`vox init`이 `.claude/skills/vox-ai/SKILL.md`를 생성합니다. Claude Code는 프로젝트를 열 때 이 스킬을 자동으로 인식하므로 따로 설치할 것이 없습니다.

같은 프로젝트에서 Claude Code를 열고 만들고 싶은 에이전트를 설명하세요.

```plaintext theme={null}
치과 예약 확인 에이전트 만들어줘.
환자 이름과 예약 시간을 확인하고, 변경이 필요하면 담당자에게 연결해줘.
만들고 나서 vox chat으로 예약 변경 시나리오까지 테스트해줘.
```

Claude Code가 CLI로 에이전트를 만들고, 검증하고, 테스트까지 진행합니다.

## Codex

`vox init`이 `.codex/skills/vox-ai/SKILL.md`를 생성합니다. Codex도 같은 방식으로 프로젝트의 스킬을 자동 인식하므로, 프로젝트에서 Codex를 열고 바로 요청하면 됩니다.

## 다른 코딩 에이전트

스킬 파일이 하는 일은 하나입니다. 설치된 `vox` 바이너리의 작업 가이드를 가리키는 것입니다. 셸 명령을 실행할 수 있는 코딩 에이전트라면 아래 명령의 출력을 지침으로 제공해 같은 방식으로 쓸 수 있습니다.

```bash theme={null}
vox guide coding-agent --brief
```

출력에는 에이전트 작성 규칙, 검증·배포 순서, 주의할 점이 담겨 있습니다. 사용하는 에이전트의 지침 파일에 이 명령을 안내해 두세요.

## CI·헤드리스 환경

브라우저 로그인 없이 환경 변수로 인증할 수 있습니다. `VOX_OAUTH_ACCESS_TOKEN`과 `VOX_ORGANIZATION_ID`를 설정하면 CI 파이프라인에서도 같은 명령을 실행합니다. 자세한 내용은 [CLI 문서의 인증과 프로필](/docs/ai/cli#인증과-프로필)을 참고하세요.

## 스킬 파일 관리

`.claude`와 `.codex` 아래의 `vox-ai` 스킬 파일은 CLI가 관리하는 산출물입니다. 직접 수정하지 마세요. CLI를 업데이트한 뒤 `vox agent skills refresh`를 실행하면 최신 템플릿으로 다시 생성됩니다. 스킬 파일 생성을 원하지 않으면 `vox init --no-agent-skills`를 사용하세요.

***

<Accordion title="연관 검색어">
  Claude Code, Codex, 코딩 에이전트, AI 클라이언트, vox init, 스킬, SKILL.md, CI, 헤드리스, 자동화, 에이전트 연동
</Accordion>