Skip to main content
OpenCode는 터미널 기반 코딩 에이전트로 사용자 지정 모델 제공자를 지원합니다. opencode.json에서 @ai-sdk/openai-compatible 패키지를 사용하여 Tokios를 제공자로 추가하고, options.baseURL를 https://api.tokios.com/v1로 지정한 다음, models 아래에 Tokios 배포 이름을 나열하세요. 그러면 OpenCode는 모든 에이전트 요청을 프라이빗 커넥터 터널을 통해 로컬 모델로 라우팅합니다.

​
사전 요구 사항

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

​
OpenCode 구성

Tokios 공급자 블록을 opencode.json 설정에 추가하세요. 정확한 설정 파일 위치(프로젝트 로컬 opencode.json 대비 전역 설정 경로)와 정확한 키 이름(options, npm, models)은 OpenCode 릴리스에 따라 다를 수 있으므로, 설치된 버전의 공급자 스키마와 대조하여 확인하세요.
opencode.json
Replace gemma-tunnel with the public deployment name you registered on the Models tab — not the local model id your backend (Ollama, llama.cpp, vLLM, or LM Studio) uses. Replace sk-tok-YOUR_KEY with your own key, and avoid committing it into a shared or version-controlled config file.
options.baseURL에는 /v1가 포함되어야 합니다. OpenCode의 OpenAI 호환 공급자는 이 URL을 기준으로 요청을 보내므로, /v1가 없는 베이스 URL은 Tokios API에 도달하지 못합니다.

​
도구를 사용할 수 있는 모델을 선택하세요.

OpenCode의 에이전트는 파일을 읽고, 명령을 실행하고, 코드를 편집하기 위해 도구 호출에 의존합니다. 모든 로컬 모델이 도구 호출을 안정적으로 처리하는 것은 아닙니다. 실제 편집에 OpenCode의 에이전트를 사용하기 전에 강력한 도구 호출 지원을 갖춘 모델로 구동되는 배포를 선택하세요. 후보를 비교하는 방법은 로컬 모델 선택을 참조하세요.

​
문제 해결

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

​
다음 단계

호환 가능한 클라이언트

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

로컬 모델을 선택하세요.

에이전트 워크플로에 배포를 적용하기 전에 백엔드와 모델을 비교하세요.