시작하기 전에
다음이 필요합니다.- 활성 Capriole AI Premium 또는 자격 있는 Team 접근
- API 페이지의 Capriole AI API key
- 설치된 코딩 에이전트 하나 이상
- 환경 변수를 설정할 수 있는 터미널
이 가이드는 호환성을 증명하기 위해 키 하나를 재사용합니다. 오래 쓰는 구성이나 팀에는 에이전트 또는 사용자마다 이름이 다른 키를 만드세요. 키를 나누면 유출된 자격 증명의 영향이 줄고, API 페이지에서 사용량을 필터링하거나 접근을 독립적으로 취소할 수 있습니다.
에이전트를 프로토콜에 맞추기
계정 키는 공유해도 각 클라이언트는 만들어진 전송 프로토콜을 유지합니다.
Responses 및 Chat Completions 경로의 Base URL에는
/v1이 포함됩니다. Anthropic Messages 경로는 API 루트를 사용합니다. 통합 페이지에 클라이언트별 어댑터 값이 문서화된 경우는 예외입니다. 일치하는 통합 페이지에서 정확한 값을 복사하세요.
공유 키 설정하기
1
Capriole API key 내보내기
에이전트를 열기 전에 셸 변수 하나를 설정하세요.시크릿을 출력하지 않고 변수가 있는지 확인하세요.예상 결과는
Capriole API key is set입니다.2
클라이언트 경로 선택하기
표의 통합 페이지를 열고 유지 중인 구성을 복사하세요. 해당 클라이언트가 토큰을 요청하는 곳마다 OpenClaw의 경우:
CAPRIOLE_AI_API_KEY의 같은 값을 사용하세요.- Codex는
env_key를 통해CAPRIOLE_AI_API_KEY에서 키를 읽습니다. - Claude Code는
ANTHROPIC_AUTH_TOKEN을 사용합니다. 시작 전에 공유 변수에서 설정하세요. - Kilo Code는 제공자 구성에서
{env:CAPRIOLE_AI_API_KEY}를 참조합니다. - GitHub Copilot CLI는 OpenAI 호환 경로에서
COPILOT_PROVIDER_API_KEY를, Anthropic Messages에서COPILOT_PROVIDER_BEARER_TOKEN을 사용합니다. - OpenCode 제공자 항목은 제공자 어댑터에 따라
apiKey또는authToken에 Capriole 키를 사용합니다. - OpenClaw 제공자 항목은
CUSTOM_API_KEY를 참조합니다. 게이트웨이를 시작하기 전에 공유 변수에서 설정하세요.
3
모델을 호환 경로에 두기
정확한 모델 버전이 필요하지 않으면 유지 중인 별칭으로 시작하세요.
- OpenAI Responses 경로에는
openai-latest를 사용하세요. - Anthropic Messages 경로에는
claude-latest를 사용하세요. - Chat Completions 호환 경로에는 통합 페이지에 나온 모델을 사용하세요.
4
에이전트를 시작하고 확인하기
테스트 프로젝트에서 구성한 클라이언트를 시작하고 다음을 요청하세요.비어 있지 않은 답을 찾으세요. 이상적으로는 요청한
CAPRIOLE_OK 마커입니다. 모델이 정확한 출력 프롬프트를 항상 따르지는 않으므로 문구가 다를 수 있습니다.그런 다음 API 페이지를 열고 요청이 예상 키와 모델 아래 사용량 보기에 나타나는지 확인하세요. 사용량 기록이 클라이언트가 Capriole을 썼다는 결정적 확인입니다. 클라이언트에 다른 제공자나 fallback이 구성되어 있으면 응답만으로는 충분하지 않습니다. API keys와 사용량 가이드에 정확한 필터와 키 수명 주기가 나와 있습니다.이 검사는 모든 도구나 모델 기능을 테스트하지 않습니다.성공의 모습
코딩 에이전트 요청은 자격 있는 개인 또는 Team API 잔액을 사용합니다. 무제한 유료 Browser Chat의 일부가 아닙니다. 큰 자동화 워크로드를 실행하기 전에 Capriole AI 과금 토큰을 읽으세요.