주요 설정
사전 요구 사항
추가 요구 사항
- VS Code가 설치되어 있음
설치
Roo Code 설치
VS Code를 열고 extensions marketplace에서 Roo Code를 검색하여 설치하세요.수동 설정
Roo Code settings UI에서 이 설정을 완료하세요. configuration file을 직접 수정할 필요가 없습니다.설정
1
충돌하는 environment variables 제거
2
Roo Code settings 열기
Roo Code Settings panel을 여세요.
3
API provider 설정
다음을 입력하세요.
- API Provider →
OpenAI Compatible - Base URL →
https://www.bettertoken.ai/v1 - API Key → BetterToken API Key
- Model → 모델 광장에서 복사한 지원되는 provider의 model ID
4
공식 문서에서 명시적으로 요구할 때만 extra headers 설정
확인한 Roo Code 공식 자료는 OpenAI-compatible 또는 custom API setup에 집중하지만 extra
User-Agent를 BetterToken의 필수 단계로 취급하지 않습니다.custom gateway, tenant routing, observability 또는 caching layer도 사용한다면 해당 upstream service의 공식 문서에 따라서만 headers를 추가하세요.5
저장 후 사용 시작
Save와 Done을 클릭한 다음 설정한 모델을 선택하세요.
6
Roo Code 다시 시작
config를 저장한 후 VS Code를 다시 시작하거나 Roo Code extension을 다시 로드한 다음 설정한 모델을 선택하세요.
Roo Code의 OpenAI Compatible provider는 여전히 OpenAI-style tool calling에 의존합니다. extra headers가 필요하면
User-Agent가 BetterToken에 필수라고 가정하지 말고 현재 Roo Code 문서 또는 upstream gateway requirements를 따르세요.연결 확인
짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.모델 전환
model selector를 열거나 configuration의Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.
일반적인 오류
- OpenAI-compatible API와 Anthropic-compatible API 비교
- MCP와 API Key 및 Base URL 비교
- model_provider, base_url 및 wire_api란 무엇인가요?
- Cline에서 OpenAI-compatible API 구성
고급 설정
지원 Provider
표시된 상태는 이 페이지에서 설명하는 BetterToken 설정 방식에 적용됩니다.
설정 방식 설명
설정 방식 설명
- 수동 설정: API Key, Base URL, Model을 입력하세요.
- 지원되지 않음: 검증된 직접 연결 방식이 아직 없습니다.
기술 세부 정보
Protocol, endpoint 및 내부 provider 필드
Protocol, endpoint 및 내부 provider 필드
이 설정은
https://www.bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.
