← 문서 목록

개발 도구 연결

Claude Code / Anthropic SDK

업데이트

설정 만들기

쓸 모델을 여러 개 고르고 「확인」을 누르면, 고른 모델을 모두 바로 쓸 수 있는 설정이 아래에 만들어집니다. 첫 번째로 고른 모델이 기본 모델이 됩니다. 컨텍스트·출력 상한·가격 같은 값은 모델 카탈로그에서 채웁니다. 이 도구는 에이전트로 동작하므로 도구 호출을 지원하는 모델만 고를 수 있습니다.

모델 불러오는 중…

Claude Code는 Anthropic Messages 형식(/v1/messages)으로 요청합니다. Base URL과 키만 바꾸면 everyais로 연결됩니다.

연결하기

  1. 대시보드에서 API 키를 만들고 크레딧을 충전합니다.
  2. 위 「설정 만들기」에서 모델을 고르고 「확인」을 누릅니다. 도구 호출을 지원하는 모델만 목록에 나옵니다. Claude 모델은 「추론 강도」도 고를 수 있습니다.
  3. 만들어진 내용을 ~/.claude/settings.json에 붙여 넣고 everyais_your_api_key를 내 키로 바꿉니다. 파일이 이미 있으면 같은 항목만 합치세요.
  4. Claude Code를 다시 시작하고 /model에 고른 모델이 보이는지 확인합니다.

키는 사용자 설정 파일(~/.claude/settings.json)에만 두세요. 프로젝트의 .claude/settings.json은 저장소에 커밋되므로 키가 공개됩니다.

모델 순서

고른 순서대로 Claude Code의 모델 별칭에 들어갑니다.

순서들어가는 자리
1번째기본 모델, opus
2번째sonnet
3번째haiku. 백그라운드 작업에도 쓰입니다

3개보다 적게 고르면 빈 자리는 앞 모델로 채웁니다. 빠르고 저렴한 모델을 마지막에 고르세요.

설정 항목

항목하는 일
ANTHROPIC_BASE_URL요청을 everyais로 보냅니다. Claude Code가 /v1/messages를 붙이므로 /v1은 넣지 않습니다
ANTHROPIC_AUTH_TOKENeveryais 키입니다. Authorization: Bearer 헤더로 보내고, 로그인한 claude.ai 계정보다 먼저 씁니다
ANTHROPIC_DEFAULT_OPUS_MODEL · ANTHROPIC_DEFAULT_SONNET_MODEL · ANTHROPIC_DEFAULT_HAIKU_MODEL위 표의 세 자리입니다. 비워 두면 Claude Code가 자기 기본 모델 이름으로 요청해 404가 날 수 있습니다
CLAUDE_CODE_MAX_OUTPUT_TOKENS요청 하나의 최대 출력 토큰입니다. 모든 모델에 함께 적용되므로 고른 모델의 출력 상한 중 가장 작은 값을 넣습니다. 상한을 모르는 모델이 있으면 넣지 않습니다
CLAUDE_CODE_MAX_CONTEXT_TOKENSClaude가 아닌 모델의 컨텍스트 크기입니다. 이 값이 없으면 Claude Code가 200K 토큰으로 보고 대화를 압축합니다. Claude 모델에는 적용되지 않습니다
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS실험 기능용 요청 필드를 끕니다. everyais가 아직 받지 않는 필드가 있습니다
modelClaude Code를 켤 때 쓰는 기본 모델
modelPicker/model 목록입니다. replaceBuiltInOptions: true로 Claude Code 기본 목록 대신 고른 모델만 보여 줍니다. 사용자 설정 파일에서만 적용되고 Claude Code 2.1.242 이상이 필요합니다
modelSettings.<모델>.effortLevelClaude 모델의 추론 강도입니다. low, medium, high, xhigh를 받고 max는 받지 않습니다. Claude Code 안에서는 /effort로 바꿉니다

키는 ANTHROPIC_API_KEY로 넣어도 됩니다. 이때는 x-api-key 헤더로 보내고, 처음 실행할 때 이 키를 쓸지 한 번 묻습니다.

참고: Claude Code는 요청 전에 POST /v1/messages/count_tokens로 토큰 수를 셉니다. 이 호출은 무료입니다. 사용량과 금액은 대시보드 사용량에서 봅니다.

Claude가 아닌 모델

Gemini나 GPT 같은 모델도 고를 수 있습니다. Claude Code는 요청을 Claude에 맞춰 만들므로 도구 호출이나 생각 과정 표시가 다르게 보일 수 있습니다. 먼저 Claude 모델로 연결을 확인하세요. 이런 모델에는 Claude Code가 추론 강도를 보내지 않으므로 모델 기본값으로 답합니다.

Anthropic SDK

Anthropic 공식 SDK(Python·TypeScript)는 아래 두 환경변수를 읽습니다. 코드는 그대로 둡니다.

bash
export ANTHROPIC_BASE_URL="https://api.everyais.com"
export ANTHROPIC_API_KEY="everyais_your_api_key"

모델 ID는 everyais/claude-sonnet-5-5처럼 everyais ID를 씁니다. 받는 파라미터는 Messages에 있습니다.

문제가 생기면

증상확인할 것
404이고 주소에 /v1/v1이 보입니다Base URL 끝의 /v1을 빼세요
401키를 다시 확인하세요. 앞뒤에 공백이 들어갔는지도 보세요
404 model_not_found모델 ID와 키의 허용 모델을 확인하세요. ANTHROPIC_DEFAULT_*_MODEL 세 개가 모두 있어야 합니다
400CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS가 "1"인지 확인하세요. 그래도 나면 error.param의 필드를 보세요
계속 claude.ai 구독으로 요청합니다settings.json을 저장하고 Claude Code를 완전히 다시 시작하세요
문의접수