메인 콘텐츠로 건너뛰기
Roo Code는 설정 패널에서 구성하는 프로바이더 프로필을 통해 모델과 통신합니다. OpenAI Compatible 프로바이더를 추가하고 Base URL을 https://api.tokios.com/v1로 API Key를 sk-tok-… 키로 Model ID를 Tokios 콘솔에서 등록한 배포 이름으로 설정하면, Roo Code는 커넥터를 통해 로컬 모델로 요청을 전송합니다.

전제 조건

  • 로컬 모델과 페어링된 실행 중인 Tokios 커넥터 — 참고: Connector install
  • 등록된 모델 배포 이름 — 참고: Register a model
  • Tokios API 키(sk-tok-…) — 참고: API Keys
  • VS Code에 Roo Code 확장 프로그램 설치 완료

OpenAI Compatible 프로바이더 설정

1

Open Roo Code's provider settings

VS Code에서 Roo Code 패널을 열고 설정으로 이동합니다. API 프로바이더로 OpenAI Compatible을 선택하세요.
2

Set the base URL

다음으로 Base URL을 설정합니다:
3

Add your API key

여기에 sk-tok-… 키를 API Key 필드에 붙여넣습니다.
4

Set the model ID

다음 Model ID를 공개 배포 이름으로 설정합니다 — Models 탭에서 등록한 값이며, 예: gemma-tunnel. 백엔드(Ollama, llama.cpp, vLLM, LM Studio)가 사용하는 로컬 모델 ID가 아닙니다.
여기서 gemma-tunnel을 실제 배포 이름으로, sk-tok-YOUR_KEY를 실제 키로 교체하세요. 둘 다 공유 설정 파일에 커밋하지 마세요.

도구 호출을 지원하는 모델 선택

Roo Code는 네이티브 도구 호출을 사용하여 파일 읽기, 명령 실행, 프로젝트 편집을 수행합니다. 기본 모델이 네이티브 도구 호출을 지원하지 않으면, Roo Code는 응답을 도구 액션으로 파싱할 수 없습니다 — 진행 대신 재시도하고 루프에 빠집니다. Tokios는 요청의 도구 호출 구조를 백엔드로 그대로 전달합니다. 도구 호출이 실제로 작동하는지는 Tokios나 커넥터가 아니라 실행 중인 모델에 전적으로 달려 있습니다. Roo Code를 실제 작업에 의존하기 전에, 배포가 네이티브 도구 호출을 지원하는 모델로 뒷받침되는지 확인하세요. 에이전트 워크로드에 대한 모델 비교 방법은 Choose a local model을 참조하세요.
네이티브 도구 호출이 없는 모델은 Roo Code와 작동하지 않습니다 — 동일한 배포를 통해 일반 채팅에서는 잘 작동할 수 있지만요. Roo Code가 동일한 단계를 재시도하며 멈춰 있는 것처럼 보이면, 이것이 가장 먼저 확인해야 할 사항입니다.

문제 해결

Roo Code가 전송한 API 키가 없거나, 형식이 잘못되었거나, 취소되었습니다. 여분의 공백 없이 전체 sk-tok-… 키를 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인하세요.
키는 유효하지만 Model ID의 배포에 대한 범위가 없거나, 계정이 정지되었습니다. Keys 탭에서 키의 허용 모델 패턴을 확인하세요.
이 Model ID 값이 등록된 배포와 일치하지 않습니다. Models 탭의 공개 이름과 정확히 일치하는지 확인하세요 — Ollama/llama.cpp/vLLM/LM Studio 로컬 모델 ID가 아닙니다.
해당 배포의 커넥터가 오프라인이거나 동시성 한도에 도달했습니다. Connectors 탭에서 커넥터가 Online인지 확인하세요.
이것은 일반적으로 Tokios 오류가 아닙니다 — 배포 뒤의 모델이 네이티브 도구 호출을 지원하지 않는다는 신호입니다. 위의 도구 호출을 지원하는 모델 선택을 참조하세요.

다음 단계

Choose a local model

Roo Code와 같은 코딩 에이전트 워크로드에 대한 모델과 백엔드를 비교하세요.

Compatible clients

다른 OpenAI 및 Anthropic 호환 클라이언트의 Base URL 및 키 설정을 확인하세요.