메인 콘텐츠로 건너뛰기
Cursor의 완성 및 에이전트 기능은 Cursor의 클라우드를 통해 실행되며 사용자의 머신에서 실행되지 않으므로, localhost나 비공개 LAN의 모델에 도달할 수 없습니다 — 공개 HTTPS 엔드포인트 가 필요합니다. Tokios는 https://api.tokios.com/v1에서 이를 제공합니다: 모델 옆에서 커넥터를 페어링하고, 배포 이름을 등록하고, Cursor에 해당 URL과 sk-tok-… 키를 제공하세요. 유지해야 할 ngrok 터널도, 인증 없는 포트도 없습니다.

전제 조건

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

Cursor가 localhost를 사용할 수 없는 이유

Cursor의 모델 요청은 노트북의 코드 에디터 프로세스가 아닌 Cursor의 백엔드에서 전송됩니다. 해당 백엔드는 127.0.0.1이나 가정/사무실 네트워크의 머신으로 가는 경로가 없습니다 — 공개 인터넷에서 HTTPS로 도달 가능한 엔드포인트만 호출할 수 있습니다. 이것이 Cursor를 단순 http://localhost:11434나 LAN IP로 지정해도 작동하지 않는 이유이며, Tokios를 포함한 모든 작동하는 설정이 로컬 모델 앞에 공개 HTTPS URL을 배치해야 하는 이유입니다.

Cursor를 Tokios로 지정

1

Open Cursor's model settings

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

Override the base URL

다음으로 Override OpenAI Base URL을 설정합니다:
항상 /v1 접미사를 유지하세요 — Cursor는 여기에 입력한 값에 /chat/completions를 추가합니다.
3

Add your deployment as a custom model

Cursor의 공개 배포 이름을 사용하여 커스텀 모델을 추가합니다 — Models 탭에서 등록한 이름이며 — 예: gemma-tunnel. 이것은 Cursor가 model 필드에서 전송하는 값이며, Ollama, llama.cpp, vLLM, LM Studio의 로컬 모델 ID가 아닙니다.
4

Paste your Tokios API key

Tokios의 sk-tok-… 키를 커스텀 모델의 API 키 필드에 붙여넣습니다. 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=*)을 사용하는 일반적인 해결책이 필요한 이유입니다. 이 조합은 작동하지만, 인증 없이 모델이 URL 뒤에서 수신하도록 두고, 터널을 재시작할 때마다 URL이 변경됩니다 — 라이브 상태인 해당 URL을 찾는 사람은 누구나 모델을 호출할 수 있습니다. Tokios의 커넥터는 아웃바운드 전용이므로 모델이 인바인드 포트를 열지 않으며, 모든 요청에 아무것도 아닌 범위 지정된 sk-tok-… 키가 포함됩니다:
  • 인증 없는 노출 없음 — 커넥터는 Tokios로 외부 연결하며, 포트에서 수신하지 않고, 요청에는 유효한 키가 필요합니다.
  • 안정적인 URL — https://api.tokios.com/v1은 재시작 사이에 변경되지 않으므로 Cursor에서 한 번만 설정하면 됩니다.
  • 범위 지정된 키 — 키는 특정 배포로 제한될 수 있으며, 유출 시 로컬 모델이나 커넥터를 건드리지 않고 즉시 취소할 수 있습니다.

문제 해결

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

다음 단계

Compatible clients

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

API keys

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