Roo Code

Roo Code는 TokenHub의 OpenAI compatible 인터페이스로 모델을 호출할 수 있습니다. 공식 설치 방식은 그대로 두고 API key, Base URL, model ID만 바꿉니다.

이 가이드에서 사용하는 TokenHub endpoint는 https://us-api.tokenhub.com/v1/chat/completions입니다.

사용할 때

작은 저장소나 테스트 프로젝트에서 시작하세요. 먼저 파일 읽기, 코드 설명, 계획 생성을 확인한 뒤 편집과 자동화 작업을 켭니다.

먼저 Roo Code 공식 문서에 따라 설치하거나 엽니다. 메뉴가 다르면 현재 공식 문서를 우선하세요.

CLI 도구는 TokenHub 자격 증명을 추가하기 전에 실행 파일이 동작하는지 먼저 확인합니다:

# open the tool, then open its model or provider settings

TokenHub API key를 만들고 TokenHub 모델 목록에서 이 도구에 맞는 모델을 선택합니다.

export TOKENHUB_API_KEY="sk-..."

키는 로컬 shell, IDE 비밀 저장소, 또는 도구의 안전한 API key 필드에 저장하세요. 저장소에 커밋하지 마세요.

Models, Providers, API Keys, OpenAI Compatible 설정 화면에서 아래 값을 입력합니다.

설정 파일 위치

필드	값
Provider settings	Roo Code provider settings or configuration profile
Provider mode	OpenAI Compatible
Required fields	Base URL, API Key, Model ID

확장이 자체 schema를 가진 경우 먼저 설정 UI를 사용하세요. UI는 같은 값을 사용자 설정에 저장하며, 버전마다 바뀔 수 있는 내부 키를 추측하지 않아도 됩니다.

Use a model that supports OpenAI tool calling for Code mode tasks.

도구가 chat, edit, apply, fast models를 나누어 두었다면 첫 테스트에서는 같은 TokenHub 모델을 사용하세요. 동작 확인 후 비용, 지연 시간, 추론 성능에 따라 분리합니다.

임시 변수는 key, 네트워크, 모델 이름 확인에만 사용하세요. 검증 후 같은 값을 위의 영구 설정으로 옮기세요.

먼저 읽기 전용 프롬프트로 모델이 컨텍스트를 읽고 파일을 바꾸지 않는지 확인합니다. 그 다음 편집이나 agent 작업을 테스트합니다.

프로젝트 README를 읽고 세 문장으로 요약해 주세요. 파일은 수정하지 마세요.

프롬프트가 성공하면 TokenHub 요청 로그에서 모델 이름, endpoint, token 사용량, billing group을 확인합니다.

증상	해결 방법
401 또는 인증 실패	`TOKENHUB_API_KEY`가 유효하고 같은 terminal, IDE, 클라이언트 프로필에 저장되어 있는지 확인합니다.
404 또는 모델 없음	TokenHub 워크스페이스에 존재하고 선택한 프로토콜과 맞는 모델 ID를 사용합니다.
endpoint 오류	Base URL을 위 값과 정확히 맞춥니다. OpenAI 호환 도구는 보통 `/v1`이 필요하고 Claude 호환 도구는 보통 필요하지 않습니다.
요청 timeout	`https://us-api.tokenhub.com`까지의 네트워크, proxy settings, 워크스페이스 allowlist를 확인합니다.
다른 모델이 사용됨	chat, edit, apply, fast, autocomplete 등 모든 모델 필드를 다시 확인합니다.