Skip to main content
Cursor의 자동 완성 및 에이전트 기능은 사용자 머신이 아니라 Cursor의 클라우드를 통해 실행되므로 localhost의 모델이나 사설 LAN의 모델에는 도달할 수 없습니다. 따라서 공개 HTTPS 엔드포인트가 필요합니다. Tokios는 https://api.tokios.com/v1에서 이를 제공합니다. 모델 옆에 커넥터를 페어링하고, 배포 이름을 등록하고, Cursor에 그 URL과 sk-tok-… 키를 넘겨주세요. 열어 둘 ngrok 터널도, 인증되지 않은 포트도 없습니다.

​
전제 조건

  • 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
  • Cursor 설치됨

​
Cursor가 단순히 localhost를 사용할 수 없는 이유

Cursor의 모델 요청은 노트북의 코드 편집기 프로세스가 아니라 Cursor의 백엔드에서 이루어집니다. 그 백엔드는 127.0.0.1나 가정 또는 사무실 네트워크의 머신으로 가는 경로가 없으며, HTTPS를 통해 공개 인터넷에서 도달할 수 있는 엔드포인트만 호출할 수 있습니다. 이것이 Cursor를 그냥 http://localhost:11434나 LAN IP로 지정하면 작동하지 않는 이유이며, 작동하는 모든 설정(Tokios 포함)이 로컬 모델 앞에 공개 HTTPS URL을 두어야 하는 이유입니다.

​
Tokios에 커서를 올리세요

1

Cursor의 모델 설정을 여세요.

설정을 Cmd+,(macOS) 또는 Ctrl+,(Windows/Linux)로 열고, 사이드바에서 Models을 선택하세요. 필드 레이블은 Cursor 버전에 따라 다를 수 있으므로, 아래 이름이 일치하지 않으면 자신의 버전을 확인하세요.
2

기본 URL 재정의

Set Override OpenAI Base URL to:
Keep the /v1 suffix — Cursor appends /chat/completions to whatever you enter here.
3

배포를 사용자 지정 모델로 추가하십시오.

Add a custom model using the public deployment name you registered in the Models tab — for example, gemma-tunnel. This is the value Cursor sends in the model field; it is not Ollama’s, llama.cpp’s, vLLM’s, or LM Studio’s local model id.
4

Tokios API 키를 붙여넣으세요

사용자 지정 모델용 Cursor의 API 키 필드에 sk-tok-… 키를 붙여넣으세요. Cursor는 모든 요청에서 이를 Bearer 토큰으로 전송합니다.
등록한 배포 이름으로 gemma-tunnel을(를) 바꾸고, 자신의 키로 sk-tok-YOUR_KEY를 바꾸세요. 둘 중 어느 것도 공유 구성 파일에 커밋하지 마세요.
이 재정의는 Cursor의 채팅 및 에이전트 패널(Cmd/Ctrl+L)에 적용됩니다. 탭 자동 완성과 인라인 편집은 이 설정과 관계없이 Cursor 자체 모델에서 계속 실행되므로 해당 2 기능은 로컬 모델에 도달하지 않습니다.

​
이것이 ngrok 터널보다 나은 이유

Cursor의 클라우드 전용 아키텍처는 흔한 해결 방법이 ngrok http 11434 더하기 OLLAMA_HOST=0.0.0.0 (또는 OLLAMA_ORIGINS=*) 로 Ollama에 아예 접근 가능하게 만드는 바로 그 이유입니다. 그 조합은 작동하지만, 터널을 다시 시작할 때마다 바뀌는 URL 뒤에서 인증 없이 모델이 수신 대기하도록 남겨 두며 — 그 URL이 활성화되어 있는 동안 그 URL을 찾는 사람은 누구나 모델을 호출할 수 있습니다. Tokios의 커넥터는 아웃바운드 전용이므로, 모델은 인바운드 포트를 열지 않으며, 모델에 대한 모든 요청은 범위가 지정된 sk-tok-… 키를, 아무것도 없는 대신에 포함합니다.
  • 인증되지 않은 노출 없음 — 커넥터는 Tokios로 연결을 걸며, 포트에서 수신 대기하지 않고, 요청에는 유효한 키가 필요합니다.
  • Stable URL — https://api.tokios.com/v1는 재시작 사이에 변경되지 않으므로, Cursor에서 한 번 설정하면 됩니다.
  • Scoped keys — 특정 배포에만 키를 제한할 수 있으며, 키가 유출되면 로컬 모델이나 커넥터에 영향을 주지 않고 즉시 해지할 수 있습니다.

​
문제 해결

Cursor가 보낸 API 키가 누락되었거나, 형식이 잘못되었거나, 해지되었습니다. 전체 sk-tok-… 키를 추가 공백 없이 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인하세요.
Cursor가 보낸 model 값이 등록된 배포와 일치하지 않습니다. Cursor의 사용자 지정 모델 이름이 Models 탭의 공개 이름과 정확히 일치하는지 확인하세요 — Ollama/llama.cpp/vLLM/LM Studio 로컬 모델 ID가 아니라.
해당 배포의 커넥터가 오프라인 상태이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — 커넥터가 Online로 표시되어야 하며, 이를 실행하는 머신이 계속 켜져 있고 연결 가능해야 합니다.

​
다음 단계

호환되는 클라이언트

다른 OpenAI 및 Anthropic 호환 클라이언트에 대한 기본 URL과 키 설정을 참조하세요

API 키

팀원과 에이전트용 sk-tok-… 키를 생성하고, 범위를 지정하고, 교체하세요