Coding Agent 설정

Roo Code 설치 및 API 설정

Roo Code를 설치하고 BetterToken Base URL 및 API Key를 설정한 다음 모델을 선택하고 일반적인 오류를 해결하세요.

Roo Code를 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 후 모델 광장에서 현재 Model ID를 선택하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
모델	모델 광장의 현재 Model ID

사전 요구 사항

최신 버전의 도구가 설치되어 있음
BetterToken API Key: 등록하고 발급받기
모델 광장의 Model ID

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

추가 요구 사항

VS Code가 설치되어 있음

설치

Roo Code 설치

VS Code를 열고 extensions marketplace에서 Roo Code를 검색하여 설치하세요.

수동 설정

Roo Code settings UI에서 이 설정을 완료하세요. configuration file을 직접 수정할 필요가 없습니다.

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
모델	모델 광장의 현재 Model ID

설정

충돌하는 environment variables 제거

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Roo Code settings 열기

Roo Code Settings panel을 여세요.

API provider 설정

다음을 입력하세요.

API Provider → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → BetterToken API Key
모델 광장에서 정확한 Model ID를 복사하세요.

공식 문서에서 명시적으로 요구할 때만 extra headers 설정

확인한 Roo Code 공식 자료는 OpenAI-compatible 또는 custom API setup에 집중하지만 extra User-Agent를 BetterToken의 필수 단계로 취급하지 않습니다.

custom gateway, tenant routing, observability 또는 caching layer도 사용한다면 해당 upstream service의 공식 문서에 따라서만 headers를 추가하세요.

저장 후 사용 시작

Save와 Done을 클릭한 다음 설정한 모델을 선택하세요.

Roo Code 다시 시작

config를 저장한 후 VS Code를 다시 시작하거나 Roo Code extension을 다시 로드한 다음 설정한 모델을 선택하세요.

연결 확인

짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.

이어서 Roo Code에 프로젝트 파일 하나를 읽고 요약하도록 요청하세요. 파일 읽기 도구를 실행하고 그 결과를 활용하는지 확인하세요. 텍스트 응답만으로는 에이전트의 도구 사용을 검증할 수 없습니다.

모델 전환

model selector를 열거나 configuration의 Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.

일반적인 오류

오류	확인할 사항
`401` 또는 `Unauthorized`	BetterToken API Key를 확인하고 앞뒤 spaces를 제거하세요.
`404`	Base URL을 확인하고 specific endpoint path를 추가하지 마세요.
`model not found`	모델 광장에서 현재 Model ID를 복사하세요.
Changes가 적용되지 않음	configuration을 저장하고 도구를 완전히 다시 시작하세요.

기술 세부 정보

Protocol, endpoint 및 내부 provider 필드

이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.