Skip to main content

​
API Key를 안전하게 보관

environment variables를 사용하고 hardcode하지 마세요. API Key를 source code 또는 config files에 직접 작성하면 version control에서 실수로 노출될 위험이 있습니다. 권장 방법은 다음과 같습니다.
Claude Code에서는 env field를 settings.json에서 사용하여 shell config에 secrets를 노출하지 말고 관리하세요.
API Key를 정기적으로 교체하세요. 노출이 의심되면 dashboard에서 즉시 key를 삭제하고 새 key를 생성하세요.

​
충분한 timeout 설정

AI model responses에는 시간이 걸릴 수 있으며 특히 complex reasoning tasks에서 그렇습니다. premature disconnects를 피할 수 있도록 timeout을 충분히 높게 설정하세요.
3000000 ms = 50분입니다. deep reasoning 또는 긴 agentic tasks에 적합합니다.

​
충돌하는 environment variables 제거

이전에 공식 Anthropic 또는 OpenAI APIs나 다른 relay service를 사용했다면 stale environment variables가 BetterToken config를 override하여 requests를 잘못된 endpoint로 조용히 보낼 수 있습니다. BetterToken을 설정하기 전에 다음을 확인하고 제거하세요.

​
Claude Code: 먼저 provider 확인

Claude provider에서는 ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL 또는 다른 model-specific variables를 설정하지 마세요. GPT provider에서는 ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL을 통해 model mappings를 추가하세요. 두 setups를 섞지 마세요. requests가 잘못된 model로 route될 수 있습니다. non-essential traffic을 비활성화하세요. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1을 설정하면 Claude Code의 background requests가 줄어들어 실제 coding tasks를 위해 API quota를 확보할 수 있습니다. Claude Code에 /v1을 추가하지 마세요. ANTHROPIC_BASE_URL은 https://www.bettertoken.ai이어야 합니다.

​
여러 tools에서 하나의 API Key 사용

같은 API Key는 Claude Code, Codex 및 external tools에서 작동합니다. quota가 공유되므로 중앙 관리가 간단해집니다. 단 endpoint는 protocol과 일치해야 합니다.
  • Claude Code / ANTHROPIC_BASE_URL: https://www.bettertoken.ai
  • Codex / OPENAI_BASE_URL / external tools: https://www.bettertoken.ai/v1
project 또는 team별 usage를 별도로 추적해야 한다면 dashboard에서 여러 API Keys를 만들고 각 tool 또는 project에 하나씩 할당하세요. external tools에서는 모델 광장의 GPT provider에서 model ID를 복사하세요.

​
문제 해결 checklist

  1. API Key가 올바른지 확인 — dashboard를 확인하고 extra spaces 없이 주의해서 붙여넣으세요.
  2. protocol에 맞는 endpoint 확인 — Claude Code는 https://www.bettertoken.ai을 사용하며 Codex / external tools는 https://www.bettertoken.ai/v1을 사용합니다.
  3. 충돌하는 env vars 확인 — echo $ANTHROPIC_AUTH_TOKEN, echo $OPENAI_BASE_URL 및 관련 commands를 실행하세요.
  4. tool의 공식 setup requirements 확인 — external tools에서는 Base URL, API Key, model ID 및 tool version을 먼저 확인하세요. tool의 공식 docs 또는 upstream gateway가 명시적으로 요구할 때만 extra headers를 추가하세요.
  5. balance 확인 — balance가 소진되면 requests가 거부됩니다.
  6. support 문의 — 위 단계로 해결되지 않으면 문의하세요.