Skip to main content
JetBrains AI Assistant에는 사용자 지정 제공업체를 위한 OpenAI-compatible endpoints 필드가 내장되어 있습니다. Tokios는 안정적이고 인증된 URL을 제공하여 그 필드에 넣을 수 있게 합니다. 모델 옆에 커넥터를 연결하고, 배포 이름을 등록한 다음, AI Assistant에 sk-tok-… 키가 포함된 해당 URL을 전달하세요. 관리할 터널도 없고, 컴퓨터의 인증되지 않은 포트도 없습니다. 이것은 AI Assistant가 포함된 JetBrains IDE 전반에서 동일하게 작동합니다 — IntelliJ IDEA, PyCharm, GoLand, WebStorm, Rider 등.

​
사전 요구 사항

  • 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
  • AI Assistant 플러그인이 설치된 JetBrains IDE

​
AI Assistant를 Tokios로 지정하세요.

1

Open AI Assistant의 프로바이더 설정

Open Settings | Tools | AI Assistant | Providers & API keys. JetBrains has moved this setting between releases, so confirm the exact menu path and label for your installed AI Assistant version.
2

OpenAI 호환 엔드포인트 섹션을 찾으세요.

Look for the OpenAI-compatible endpoints section, used for third-party OpenAI-compatible servers — the exact field labels shown here can vary by version, so check yours.
3

Tokios URL을 입력하세요.

엔드포인트 URL을 다음으로 설정하세요.
4

Tokios API 키를 붙여넣으세요

이 엔드포인트의 API 키 필드에 sk-tok-… 키를 붙여넣으세요. AI Assistant는 모든 요청에서 이를 Bearer 토큰으로 전송합니다.
5

배포를 모델로 추가하세요

Enter the public deployment name you registered in the Models tab — for example, gemma-tunnel — as the model for this endpoint. This is the value AI Assistant sends in the model field; it is not Ollama’s, llama.cpp’s, vLLM’s, or LM Studio’s local model id.
6

필요하다면 도구 호출을 전환하세요.

AI Assistant가 이 엔드포인트에서 도구/함수 호출 토글을 노출한다면 활성화하세요. 모델이 도구 호출에 실제로 반응하는지 여부는 기본 모델 자체에 달려 있습니다.
등록한 배포 이름으로 gemma-tunnel를 바꾸고, 본인의 키로 sk-tok-YOUR_KEY를 바꾸세요. 둘 중 어느 것도 공유 구성 파일에 커밋하지 마세요.
JetBrains IDE의 AI Assistant 사용자 지정 공급자 지원은 OpenAI 호환 슬롯으로 문서화되어 있습니다. 확인된 사용자 지정 Anthropic 호환 기본 URL 필드는 없으므로 Tokios의 Anthropic 스타일 엔드포인트가 아닌 위의 OpenAI 호환 엔드포인트를 통해 연결하세요.
사용자 지정 엔드포인트가 모든 AI Assistant 기능을 지원하지는 않습니다. 2026.1 릴리스 기준으로 JetBrains는 타사 및 로컬 모델이 AI Chat에서 작동한다고 문서화하고 있으며, Junie와 다음 편집 제안은 여전히 JetBrains의 클라우드 모델을 필요로 합니다. 채팅은 전환되고 인라인 제안은 기본 제공 공급자에 유지될 것으로 예상하세요.
프로바이더 설정에서 Test Connection을 사용하여 모델을 기능에 할당하기 전에 엔드포인트가 응답하는지 확인하세요.

​
왜 이것이 기본 터널보다 나은가

앞에 아무것도 없으면 로컬 모델 서버는 localhost 또는 LAN에서만 수신 대기하며, JetBrains의 클라우드 호스팅 AI Assistant 백엔드는 어느 쪽에도 도달할 수 없습니다. 원시 터널(예를 들어 ngrok)은 포트를 노출할 수 있지만, 일반적으로 이는 모델이 인증 없이 수신 대기하는 상태로 남겨 두며 해당 URL은 재시작할 때마다 변경됩니다. Tokios 커넥터는 아웃바운드 전용이므로 모델이 인바운드 포트를 여는 일이 없으며, 모든 요청에는 범위가 지정된 sk-tok-… 키가 포함됩니다.
  • 인증되지 않은 노출 없음 — 커넥터는 Tokios로 아웃바운드 연결을 하며, 포트에서 수신 대기하지 않고, 요청에는 유효한 키가 필요합니다.
  • 안정적인 URL — https://api.tokios.com/v1 는 재시작 사이에 변경되지 않으므로 AI Assistant에서 한 번 설정하면 됩니다.
  • Scoped keys — 키는 특정 배포로 제한될 수 있으며, 유출 시 로컬 모델이나 커넥터를 건드리지 않고 즉시 폐기할 수 있습니다.

​
문제 해결

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

​
다음 단계

빠른 시작

커넥터를 설정하고, 모델을 등록하고, 처음부터 키를 만드세요.

호환되는 클라이언트

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