Skip to main content
어떤 클라이언트를 쓰든 준비는 같습니다. vox CLI를 설치하고 로그인한 뒤, 작업할 프로젝트에서 vox init을 실행하세요. 
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를 열고 만들고 싶은 에이전트를 설명하세요. 
치과 예약 확인 에이전트 만들어줘.
환자 이름과 예약 시간을 확인하고, 변경이 필요하면 담당자에게 연결해줘.
만들고 나서 vox chat으로 예약 변경 시나리오까지 테스트해줘.
Claude Code가 CLI로 에이전트를 만들고, 검증하고, 테스트까지 진행합니다.

​
Codex

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

​
다른 코딩 에이전트

스킬 파일이 하는 일은 하나입니다. 설치된 vox 바이너리의 작업 가이드를 가리키는 것입니다. 셸 명령을 실행할 수 있는 코딩 에이전트라면 아래 명령의 출력을 지침으로 제공해 같은 방식으로 쓸 수 있습니다. 
vox guide coding-agent --brief
출력에는 에이전트 작성 규칙, 검증·배포 순서, 주의할 점이 담겨 있습니다. 사용하는 에이전트의 지침 파일에 이 명령을 안내해 두세요.

​
CI·헤드리스 환경

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

​
스킬 파일 관리

.claude와 .codex 아래의 vox-ai 스킬 파일은 CLI가 관리하는 산출물입니다. 직접 수정하지 마세요. CLI를 업데이트한 뒤 vox agent skills refresh를 실행하면 최신 템플릿으로 다시 생성됩니다. 스킬 파일 생성을 원하지 않으면 vox init --no-agent-skills를 사용하세요.
Claude Code, Codex, 코딩 에이전트, AI 클라이언트, vox init, 스킬, SKILL.md, CI, 헤드리스, 자동화, 에이전트 연동