메인 콘텐츠로 건너뛰기
Cline는 Tokios와 OpenAI Compatible 프로바이더를 통해 통신합니다. Base URL은 https://api.tokios.com/v1, API Key는 sk-tok-…, Model ID는 등록한 Tokios deployment 이름으로 설정하고 Cline이 모든 요청을 프라이빗 터널을 통해 로컬 모델로 라우팅합니다.

전제 조건

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

Cline에서 OpenAI Compatible 프로바이더 설정

1

Open Cline's settings

Cline 패널에서 톱니바퀴 아이콘을 클릭하여 Settings를 엽니다.
2

Select the OpenAI Compatible provider

드롭다운에서 API Provider를 선택하고 OpenAI Compatible을 선택합니다.
3

Set the Base URL

다음 Base URL 필드에 입력합니다:
4

Set the API Key

다음 API Key 필드에 Tokios 키를 붙여넣습니다:
5

Set the Model ID

다음 Model ID 필드에 Tokios deployment 이름을 입력합니다 — Models 탭에서 등록한 공개 이름이며, 예: gemma-tunnel. 백엔드가 사용하는 로컬/업스트림 모델 ID가 아닙니다.
6

Set context window and max output manually

OpenAI Compatible 프로바이더는 모델 한도를 자동 감지하지 않습니다. Cline이 요청 크기를 올바르게 조정할 수 있도록 배포의 기본 모델에 맞게 Context Window와 Max Output Tokens를 수동으로 입력하세요.
항상 Model ID 필수는 등록한 deployment 이름이며 Ollama, llama.cpp, vLLM, LM Studio의 업스트림 모델 ID가 아닙니다 — 참고: Register a model.

curl에서는 작동하지만 Cline에서 400 오류가 반환되는 경우

일반 curl 요청이 https://api.tokios.com/v1/chat/completions에서 성공하지만 Cline에서 400이 반환되면 다음 순서대로 확인하세요:
Cline은 /chat/completions를 Base URL에 입력한 값에 추가합니다. https://api.tokios.com/v1을 입력하세요 — 전체 경로(https://api.tokios.com/v1/chat/completions)를 붙여넣으면 Cline이 이중화된 경로로 요청하여 Tokios가 오류를 반환합니다. Tokios는 안정적인 /v1 OpenAI 서버를 제공하므로 루트는 명확합니다: 항상 https://api.tokios.com/v1이며 뒤에 아무것도 붙지 않습니다.
해당 Model ID 필드는 Models 탭에 표시된 정확한 공개 배포 이름과 정확히 일치해야 하며, 업스트림 모델 ID가 아니며, 오타가 있는 변형도 안 됩니다. 일치하지 않는 이름은 일반적으로 404로 나타나지만, 잘못된 모델 문자열(여분의 공백, 배포에서 대소문자를 구분하는 경우 잘못된 대소문자)도 400으로 반환될 수 있습니다.
Cline은 기본적으로 스트리밍 응답을 요청합니다. Tokios는 "stream": true에 대해 /v1/chat/completions에서 표준 OpenAI 형식 SSE를 반환하므로 기본적으로 작동해야 합니다. Cline이 전송하는 요청 파라미터를 로컬 백엔드가 지원하지 않으면, Tokios가 라우팅 문제를 확인하기도 전에 백엔드가 400으로 거부할 수 있습니다.
400 오류는 Base URL과 Model ID가 모두 정확할 때 Tokios가 요청 본문 자체를 처리할 수 없음을 보고하는 것입니다. Cline의 고급 설정에서 잘못된 프로바이더별 옵션(일반적인 OpenAI Compatible 백엔드가 기대하지 않는 필드)이 있는지 확인하세요.

오류 참조

다음 단계

Cline을 Tokios로 향하게 설정하면, 동일한 Base URL, API 키, 배포 이름이 함께 실행하는 다른 OpenAI 호환 도구에도 작동합니다 — 클라이언트마다 추가 터널이나 포트 포워딩이 필요 없습니다.

Compatible clients

지원되는 다른 클라이언트의 Base URL 및 키 설정을 확인하세요.

API keys

팀원과 에이전트를 위한 sk-tok-… 키를 생성, 범위 지정, 로테이션하세요.