https://api.tokios.com/v1로 설정하고, API Key를 사용자의 sk-tok-… 키로 설정하며, Model ID를 등록된 Tokios 배포 이름으로 설정하세요. 그러면 Cline은 모든 요청을 사용자의 프라이빗 터널을 통해 로컬 모델로 라우팅합니다.
전제 조건
- 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 — see API Keys
- VS Code(또는 호환 편집기)에 설치된 Cline 확장 프로그램
Cline에서 OpenAI 호환 공급자를 구성하세요.
1
Cline의 설정을 엽니다.
Cline 패널에서 기어 아이콘을 클릭하여 Settings를 엽니다.
2
OpenAI Compatible 공급자를 선택하세요.
드롭다운 API Provider에서 OpenAI Compatible를 선택하세요.
3
Base URL 설정
다음 Base URL 필드에 입력하세요.
4
API 키 설정
다음 API Key 필드에 Tokios 키를 붙여넣으세요.
5
모델 ID 설정
In the Model ID field, enter your Tokios deployment name — the public name you registered in the Models tab, for example
gemma-tunnel. This is not the local/upstream model id your backend uses.6
컨텍스트 창과 최대 출력을 수동으로 설정
OpenAI 호환 공급자는 모델 한도를 자동 감지하지 않습니다. 배포의 기본 모델과 일치하도록 Context Window 및 Max Output Tokens를 입력하면 Cline이 요청 크기를 올바르게 조정합니다.
curl에서 작동했지만 400는 Cline에서 발생합니다.
일반curl 요청이 https://api.tokios.com/v1/chat/completions에 성공하지만 Cline이 400를 반환하는 경우 다음 순서대로 진행하세요.
Base URL은 /v1 루트이며, 전체 chat/completions 경로가 아닙니다.
Base URL은 /v1 루트이며, 전체 chat/completions 경로가 아닙니다.
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이며 추가되는 것이 없습니다.모델 ID가 배포 이름과 정확히 일치하지 않습니다
모델 ID가 배포 이름과 정확히 일치하지 않습니다
이 Model ID 필드는 Models 탭에 표시된 정확한 공개 배포 이름이어야 합니다 — 업스트림 모델 ID도, 오타가 난 변형도 아닙니다. 이름이 일치하지 않으면 일반적으로 404로 나타나지만, 잘못된 모델 문자열(추가 공백, 배포가 엄격하게 구분하는 잘못된 대소문자)은 400로 돌아올 수도 있습니다.
스트리밍
스트리밍
Cline은 기본적으로 스트리밍 응답을 요청합니다. Tokios는
"stream": true에 대해 /v1/chat/completions에서 표준 OpenAI 형식 SSE를 반환하므로 별도의 설정 없이 바로 작동합니다. Cline이 보내는 요청 매개변수를 로컬 백엔드가 지원하지 않는 경우, 백엔드는 Tokios가 라우팅 문제를 보기도 전에 이를 400(으)로 거부할 수 있습니다.형식이 잘못된 요청 본문
형식이 잘못된 요청 본문
어떤 400은 Tokios가 요청 본문 자체를 처리할 수 없음을 보고하는 것입니다. 기본 URL과 모델 ID가 모두 정상이라면, Cline의 고급 설정에서 잘못 들어간 제공자별 옵션(일반 OpenAI 호환 백엔드가 기대하지 않는 필드)을 확인하세요.
오류 참조
어디에서나, 당신의 모델이 당신의 에이전트를 구동합니다
일단 Cline이 Tokios를 가리키도록 설정되면, 동일한 Base URL, API 키, 배포 이름이 그 옆에서 실행하는 다른 OpenAI 호환 도구에서도 작동합니다 — 클라이언트별 추가 터널이나 포트 포워딩이 필요 없습니다.호환 가능한 클라이언트
다른 지원되는 모든 클라이언트에 대한 기본 URL 및 키 설정을 확인하세요.
API 키
팀원과 에이전트를 위한
sk-tok-… 키를 생성하고, 범위를 지정하고, 순환하세요.