Cline의 BetterToken OpenAI 호환 설정
BetterToken에 맞는 Cline provider, Base URL, API Key 및 Model ID를 입력한 다음 연결을 확인하고 일반적인 errors를 해결하세요.
바로 답변
Cline에서 OpenAI Compatible를 선택하고 Base URL을 https://bettertoken.ai/v1로 설정한 뒤 BetterToken API Key를 붙여넣고 Model ID를 입력하세요. Claude Code용 Anthropic-compatible address를 사용하지 말고 official OpenAI provider를 선택하지 마세요.
| Cline field | BetterToken 값 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://bettertoken.ai/v1 |
| API Key | BetterToken API Key |
| Model ID | 모델 광장의 모델 ID |
전체 설정
API Key와 Model ID 준비
API Key를 만든 다음 모델 광장의 현재 available Model ID를 복사하세요. marketing display name 대신 표시된 그대로 ID를 입력하세요.
Cline settings 열기
VS Code에서 Cline panel을 열고 gear icon을 클릭하세요.
OpenAI Compatible 선택
API Provider 아래에서 OpenAI Compatible를 선택하세요. 이 provider는 Cline을 third-party OpenAI-compatible endpoint에 연결합니다.
필수 values 네 개 입력
위 table을 사용하여 Provider, Base URL, API Key 및 Model ID를 입력하세요. Base URL에는 /v1이 포함되어야 합니다.
Use Azure Identity Authentication이 표시되면 disabled로 두세요. BetterToken은 Azure Identity가 아닌 API Key로 authenticate합니다.
연결 확인
Cline에서 Verify를 클릭하세요. verification에 성공하면 task를 만들고 간단한 prompt를 보내 model이 response하고 tool calls가 작동하는지 확인하세요.
어떤 advanced fields를 변경해야 하나요?
Cline에는 Context Window, Max Output Tokens, Image Support 또는 Computer Use도 표시될 수 있습니다. 첫 connection에서는 defaults를 유지하세요. 모델 광장 또는 model documentation이 relevant capability와 limit를 확인할 때만 field를 변경하세요.
Model prices는 변경될 수 있습니다. local Cline settings에 저장된 fixed price에 의존하지 말고 모델 광장에서 current model과 price를 확인하세요.
일반적인 오류
| 증상 | 먼저 확인할 사항 | 해결 방법 |
|---|---|---|
Invalid API Key 또는 401 | Key가 complete하고 current account에 속하는지 | Key를 다시 복사하고 surrounding spaces를 제거하며 official OpenAI Key와 섞지 마세요. |
Model Not Found | Model ID | 모델 광장에서 case 또는 suffix를 변경하지 않고 available ID를 복사하세요. |
404 또는 endpoint not found | /v1 누락 여부 | Anthropic-compatible Claude Code address가 아니라 https://bettertoken.ai/v1을 사용하세요. |
| Connection timeout | local network, firewall 또는 stale proxy settings | browser에서 BetterToken이 열리는지 확인하고 invalid proxy를 disable한 다음 Verify를 다시 실행하세요. |
| Old configuration이 계속 적용됨 | Cline session이 refresh되지 않음 | settings를 저장하고 Cline을 다시 열거나 Developer: Reload Window를 실행하세요. |
이 setup이 적용되는 곳
이 values는 BetterToken OpenAI-compatible endpoint를 통해 Cline을 models에 연결합니다. Cline Rules, Memory Bank, MCP 또는 local tool permissions는 변경하지 않습니다.
Claude Code에는 /v1 없는 Anthropic-compatible address를 사용하고 Claude Code 설정 가이드를 따르세요.
관련 문서
- 전체 Cline 설정 가이드
- OpenAI-compatible API와 Anthropic-compatible API 비교
- Base URL, API Key 및 Model ID의 관계
- MCP와 API Key 및 Base URL 비교
