Skip to main content
인증 방식은 OAuth와 API 토큰 두 가지입니다. 대화형 환경에서는 OAuth, CI/CD나 스크립트에서는 API 토큰을 사용하세요.

​
비교

항목OAuthAPI 토큰
스코프사용자 단위조직 단위
인증 흐름브라우저 로그인헤더에 토큰 전달
조직 선택list_organizations로 선택 가능토큰에 조직이 고정됨
적합한 환경대화형 (터미널, IDE)CI/CD, 스크립트, 자동화
보안JWT 자동 갱신토큰 직접 관리

​
OAuth (권장)

브라우저에서 vox.ai에 로그인하면 인증이 완료됩니다. Plugin 설치 시 자동으로 OAuth 창이 열립니다. 특징:
  • 사용자 계정에 연결된 모든 조직에 접근 가능
  • list_organizations 도구로 조직을 선택하여 작업
  • JWT 자동 갱신으로 토큰 관리 불필요
지원 앱: 모든 AI 앱

​
API 토큰

vox.ai 대시보드에서 발급하는 조직 단위 토큰입니다. HTTP 헤더로 전달하세요. 
Authorization: Bearer sk_...
특징:
  • 발급 시 선택한 조직에 고정
  • list_organizations 도구 사용 불가 (조직이 이미 결정됨)
  • 토큰 관리와 교체를 직접 처리해야 함
지원 앱: Claude Code, Codex, Cursor

​
선택 기준

상황권장 방식
Claude Code에서 에이전트 관리OAuth
OpenAI Codex에서 Plugin 설치OAuth
CI/CD에서 자동 평가 실행API 토큰
ChatGPT에서 에이전트 생성OAuth (유일한 옵션)
스크립트에서 대량 통화 실행API 토큰

​
API 토큰 발급

1

대시보드 접속

vox.ai 대시보드에 로그인하세요.
2

설정 > API 토큰

설정 > API 토큰 메뉴에서 새 토큰을 생성하세요.
3

토큰 저장

생성된 토큰을 환경 변수에 저장하세요. 토큰은 생성 시 한 번만 표시됩니다.
export VOX_API_KEY="sk_..."

​
클라이언트별 인증 지원

클라이언트OAuthAPI 토큰설정 페이지
Claude CodeOO가이드
OpenAI CodexOO가이드
Claude CoworkOX가이드
ChatGPTOX가이드
CursorOO가이드

​
관련 문서

인증, OAuth, API 토큰, JWT, Bearer, MCP 인증, sk_, 토큰 발급, 조직 스코프