자주 묻는 질문
BetterToken 계정, 결제, 잔액, 사용량, API Key, Base URL, 모델 호출, 외부 도구 설정 및 일반적인 연결 오류에 대한 답변과 해결 방법을 확인하세요.
AI 코딩 도구 FAQ
이 페이지들은 Claude Code, Codex, Cursor, Cline 등 AI 코딩 도구의 개념을 찾는 개발자를 위한 문서입니다. 먼저 도구를 설명하고 API Key, Base URL, 프로토콜 선택, 사용량 확인이 BetterToken과 어떻게 연결되는지 안내합니다.
- Claude Code란 무엇이며 어떻게 작동하나요?
- Claude Code와 Claude Desktop 비교
- 로컬 개발에서 Claude Code와 Cursor 비교
- Claude Code는 Claude.ai 계정과 API Key 중 무엇을 사용하나요?
- Claude Code에서 API Key와 Base URL 설정하기
- Claude Code의 Kimi K3 연결 설정: Kimi K3를 Claude Code에 연결하고
settings.json또는 VS Code에 BetterToken API Key, Base URL,kimi-k3모델 매핑을 설정합니다. - Claude Code의 CLAUDE.md란 무엇인가요?
- Claude Code에서 Sonnet과 Opus 전환하기
- Claude Code 권한과 훅 이해하기
- Claude Desktop에서 MCP 설정하기
- Claude Desktop 사용자 지정 연결
- Claude Desktop: SSL 및 로딩 오류 해결: CC Switch의 로컬 라우팅과 Needs model mapping을 확인해 Claude Desktop의 무응답 및 SSL 인증서 만료 오류를 해결하세요.
- Claude Desktop Cowork와 Code Gateway 비교
- Codex CLI란 무엇인가요?
- Codex CLI, Codex App, Codex Web 비교
- Codex CLI config.toml 설정하기
- Codex: 1M 토큰의 GPT-5.6 Sol 설정:
config.toml에서 GPT-5.6 Sol의 백만 토큰 컨텍스트 예산과 자동 압축 임계값을 설정하거나 한 번의 Codex CLI 세션에만 적용합니다. - Codex CLI의 model_provider, base_url, wire_api란 무엇인가요?
- Codex CLI의 review_model과 reasoning_effort는 무엇인가요?
- Codex CLI의 AGENTS.md란 무엇인가요?
- Codex CLI 샌드박스와 승인 모드란 무엇인가요?
- Codex API 모드에서 GPT-6 Astra를 설정하려면?
- 타사 API와 함께 공식 Codex 로그인 상태 유지하기
- Codex 로그인 유지하며 외부 GPT Image 사용: Codex 공식 로그인과 채팅 설정을 유지하면서 별도의 이미지 스킬로 BetterToken GPT Image API를 연결하고 이미지를 생성·편집하는 방법과 오류 해결 절차를 안내합니다.
- Cursor에서 사용자 지정 OpenAI API Key와 Base URL 설정하기
- Cursor Rules, AGENTS.md, .cursorignore 이해하기
- Cursor에서 MCP 설정하기
- Cline에서 OpenAI 호환 API 설정하기
- OpenCode의 GLM API 연결 설정: BetterToken API Key, Base URL 및 정확한 Model ID로 OpenCode에서 GLM을 설정한 뒤 선택한 모델을 확인하고 인증 및 설정 오류를 해결하세요.
- OpenCode의 Kimi K3 API 연결 설정: BetterToken으로 Kimi K3를 OpenCode에 연결하고
/connect또는opencode.json에 API Key, Base URL,kimi-k3Model ID를 설정합니다. - OpenAI 호환 API와 Anthropic 호환 API 비교
- Claude Code와 Codex CLI 비교
- MCP와 API Key 및 Base URL 비교
계정 및 과금
- 추천 프로그램 보상 규칙: 친구의 가입과 첫 충전 후 추천 보상이 지급되는 방식, 보상 잔액 사용법과 수동 검토가 적용되는 경우를 알아보세요.
BetterToken은 사용량을 어떻게 과금하나요?
BetterToken은 실제 Token 사용량을 기준으로 과금하며 Anthropic / OpenAI 가격에 별도 할증을 추가하지 않습니다.
자세한 내용은 가격 페이지에서 확인하세요.
가입 후 환불받을 수 있나요?
유료 충전액의 환불이 필요하면 고객 지원에 문의하세요.
하나의 API Key를 여러 도구에서 사용할 수 있나요?
예. 같은 API Key를 Claude Code, Codex, Cursor 등 여러 도구에서 동시에 사용할 수 있으며 사용량은 공유됩니다.
사용량은 어디에서 확인하나요?
Dashboard에 로그인하면 현재 사용량과 과금 내역을 확인할 수 있습니다.
설정 및 구성
BetterToken의 base_url은 무엇인가요?
BetterToken은 프로토콜에 따라 서로 다른 두 엔드포인트를 사용합니다.
| 사용 환경 | Base URL |
|---|---|
Claude Code / ANTHROPIC_BASE_URL | https://bettertoken.ai |
Codex / OPENAI_BASE_URL / 외부 도구 | https://bettertoken.ai/v1 |
모든 도구에서 하나의 주소를 재사용하지 마세요.
Claude Code에서 모델을 지정해야 하나요?
BetterToken API Key, Base URL https://bettertoken.ai, 사용할 Model ID를 설정해 Claude Code를 연결하세요. YOUR_MODEL_ID를 복사한 ID로 바꾸세요. ANTHROPIC_MODEL은 기본 모델을, 세 개의 ANTHROPIC_DEFAULT_*_MODEL 변수는 Haiku, Sonnet, Opus 별칭을 설정합니다. 같은 모델이나 역할별로 다른 모델을 지정할 수 있습니다. 모델 광장에서 정확한 Model ID를 복사하세요.
Codex에서 모델을 지정해야 하나요?
모델 광장에서 정확한 Model ID를 복사하세요.
Cursor 같은 다른 도구에서도 모델을 지정해야 하나요?
모델 광장에서 정확한 Model ID를 복사하세요.
OpenClaw와 다른 외부 도구에 추가 헤더가 필요한가요?
일반적으로 필요하지 않습니다.
확인한 공식 문서에 따르면 Cursor, Cline, Zed 같은 일반적인 외부 도구에서는 Base URL, API Key, 모델 ID를 설정합니다. OpenCode와 OpenClaw는 선택적 headers도 지원하지만 공식 문서에서는 이를 BetterToken의 필수 설정이 아닌 사용자 지정 헤더 또는 사용자 지정 인증 용도로 설명합니다.
도구의 공식 문서나 자체 업스트림 게이트웨이, 테넌트 라우팅, 관측성 또는 캐시 계층에서 명시적으로 요구할 때만 추가 헤더를 설정하세요.
설정 후 인증에 실패하면 어떻게 해야 하나요?
다음 항목을 확인하세요.
- API Key가 정확하고 불필요한 공백이 없는지 확인하세요.
- Claude Code는
https://bettertoken.ai을 사용하고 Codex / 외부 도구는https://bettertoken.ai/v1을 사용하는지 확인하세요. - 기존
ANTHROPIC_AUTH_TOKEN,ANTHROPIC_BASE_URL,OPENAI_API_KEY,OPENAI_BASE_URL변수가 설정을 덮어쓰는지 확인하세요. - 외부 도구의 버전 제한, 모델 허용 목록 또는 업스트림 게이트웨이가 명시적으로 요구하는 추가 헤더 같은 공식 요구 사항을 확인하세요.
문제가 계속되면 고객 지원에 문의하세요.
모델 호출
- 올바른 AI 모델은 어떻게 선택하나요?: 프로토콜, 작업 유형, 품질, 속도, 컨텍스트 길이, 비용을 기준으로 AI 모델을 선택하는 방법을 알아보세요.
- 모델이 자기 버전을 잘못 답하는 이유: API 호출에서 모델이 자신의 버전을 잘못 답할 수 있는 이유와 실제 사용된 모델을 확인하는 방법을 알아보세요.
- Base URL은 어떻게 입력해야 하나요?: Claude Code, Codex CLI, Cursor, Cline 등에서 Base URL,
/v1경로, API Key, Model ID를 올바르게 맞추는 방법을 알아보세요. - max_tokens의 역할과 기본 동작:
max_tokens,max_completion_tokens,max_output_tokens의 의미와 모델 호출 시 출력 토큰 한도를 설정하는 방법을 알아보세요. - Pydantic로 구조화된 JSON을 검증하려면?: LLM이 반환한 JSON을 Pydantic로 검증하고 원본 응답을 보존하며 복구와 재시도를 명시적으로 처리합니다.
비용 및 토큰
- Claude Code가 많은 Token을 사용하는 이유와 비용 줄이기
- 캐시 과금: 프롬프트 캐시, 캐시 적중 필드, 프로토콜 차이, 요청에서 캐시된 토큰을 사용했는지 확인하는 방법을 알아보세요.
- Responses·Messages 입력 토큰 차이: 같은 API Key와 모델로 Responses API와 Messages API를 호출해도 입력 토큰이 다른 이유를 알아보고 요청을 공정하게 비교하는 방법을 확인하세요.
안정성과 Rate Limit
- Codex 사용 한도와 API 요청 속도 제한 구분하기: Codex 플랜 사용 한도와 API 요청 속도 제한, 사용 상한, BetterToken 잔액 문제를 구분합니다.
BetterToken은 어떻게 안정성을 유지하나요?
BetterToken은 여러 공급자에 연결하고 다음 메커니즘을 사용합니다.
- 다중 공급원: 한 공급자에 장애가 발생해도 전체 요청이 중단되지 않습니다.
- 동적 라우팅: BetterToken이 가장 빠르고 안정적인 경로를 실시간으로 선택합니다.
- 핵심 도구 집중: Claude Code와 Codex 생태계의 안정성을 우선합니다.
Rate Limit이나 시간 초과가 발생하면 어떻게 해야 하나요?
BetterToken은 개별 공급자의 Rate Limit과 시간 초과를 자동으로 처리합니다. 문제가 계속되면 다음을 확인하세요.
- 잔액이 충분한지 확인하세요.
- 도구의 시간 제한을 늘리세요. (
API_TIMEOUT_MS=3000000권장) - 고객 지원에 문의해 현재 할당량 상태를 확인하세요.
BetterToken은 프로덕션 환경에 적합한가요?
BetterToken은 주로 Claude Code와 Codex 같은 AI 코딩 도구를 사용하는 개인 개발자를 위해 설계되었습니다. 대규모 프로덕션 API 워크로드에는 자체 요구 사항에 맞춰 평가하세요.
개인정보 보호 및 보안
- BetterToken의 데이터 보안: BetterToken API의 데이터 보안 범위를 확인하고 HTTPS 전송, 로그, 사용 기록과 사용자 측 보안 수칙을 알아보세요.
BetterToken은 요청 내용을 저장하나요?
BetterToken은 릴레이 역할을 하며 대화 내용을 영구 저장하지 않습니다. 자세한 내용은 개인정보 처리방침을 확인하세요.
API Key가 유출되면 어떻게 해야 하나요?
즉시 Dashboard에 로그인해 기존 Key를 삭제하고 새 Key를 만드세요. 그런 다음 해당 Key를 사용하는 모든 도구를 업데이트하세요.
지역별 이용
- 러시아에서 API를 쓰려면 VPN이 필요한가요?: 러시아 사용자가 지역 사이트와 API에 직접 접속하는 방법, VPN이 필요 없는 경우 및 네트워크 문제 해결 방법을 알아보세요.
