Skip to main content
Roo Code는 설정 패널에서 구성하는 프로바이더 프로필을 통해 모델과 통신합니다. OpenAI Compatible 프로바이더를 추가하고, Base URL를 https://api.tokios.com/v1로 설정하고, API Key를 여러분의 sk-tok-… 키로 설정하고, Model ID를 Tokios 콘솔에서 등록한 배포 이름으로 설정하세요. 그러면 Roo Code는 커넥터를 통해 해당 머신이 어디에 있든 로컬 모델로 요청을 보냅니다.

​
사전 요구 사항

  • A running Tokios connector paired with your local model — see Connector Install
  • A registered model deployment name — see Register a Model
  • A Tokios API key (sk-tok-…) — see API Keys
  • VS Code에 설치된 Roo Code 확장 프로그램

​
OpenAI 호환 공급자 구성

1

Roo Code의 프로바이더 설정을 엽니다.

VS Code에서 Roo Code 패널을 열고 설정으로 이동합니다. API 제공자로 OpenAI Compatible를 선택합니다.
2

기본 URL을 설정하세요.

다음 값으로 Base URL을(를) 설정
3

API 키를 추가하세요

자신의 sk-tok-… 키를 API Key 필드에 붙여넣으세요. Roo Code는 모든 요청에서 이를 Bearer 토큰으로 전송합니다.
4

모델 ID 설정

Set Model ID to the public deployment name you registered in the Models tab — for example, gemma-tunnel. This is not the local model id your backend (Ollama, llama.cpp, vLLM, or LM Studio) uses.
자신의 배포 이름으로 gemma-tunnel을(를) 교체하고, 자신의 키로 sk-tok-YOUR_KEY를 교체하세요. 둘 중 어느 것도 공유 설정 파일에 커밋하지 마세요.

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

Roo Code는 네이티브 도구 호출에 의존하여 프로젝트에서 파일을 읽고, 명령을 실행하고, 편집을 적용합니다. 기본 모델이 네이티브 도구 호출을 지원하지 않으면 Roo Code는 응답을 도구 작업으로 파싱할 수 없습니다. 그러면 재시도와 반복만 반복할 뿐 진전이 없습니다. Tokios는 요청의 tool-call 구조를 백엔드로 그대로 전달합니다. tool calling이 실제로 작동하는지는 전적으로 실행 중인 모델에 달려 있으며, Tokios나 커넥터에 달려 있지 않습니다. 실제 작업에서 Roo Code를 사용하기 전에 배포가 기본 tool-calling 지원을 갖춘 모델로 뒷받침되는지 확인하세요. 에이전트 워크로드에 맞는 모델을 비교하는 방법은 로컬 모델 선택을 참조하세요.
네이티브 도구 호출 기능이 없는 모델은 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 오류가 아닙니다. 배포 뒤에 있는 모델이 네이티브 도구 호출을 지원하지 않는다는 신호입니다. 위의 도구 호출을 지원하는 모델 선택을 참조하세요.

​
다음 단계

로컬 모델 선택

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

호환 클라이언트

다른 OpenAI 및 Anthropic 호환 클라이언트의 base URL과 키 설정을 참조하세요.