OpenCode

OpenCode 설정 가이드

UnoRouter을 OpenCode의 커스텀 제공자로 추가하고 아무 모델이나 활성 에이전트로 고르세요.

개요

OpenCode는 JSON 설정에서 제공자를 읽습니다. OpenAI 호환 어댑터로 UnoRouter을 추가하면 모든 UnoRouter 모델을 쓸 수 있습니다.

빠른 설정

클라이언트에 붙여 넣으세요. 로그인 상태면 키가 자동으로 채워집니다.

text

기본 URL: https://api.unorouter.com/v1
API 키: YOUR_API_KEY

API 키를 자동 입력하려면 로그인하세요

호환성

Chat Completions스트리밍도구 호출

단계별 설정

1
OpenCode 설정 파일 열기
OpenCode 설정 파일을 텍스트 편집기로 엽니다. 파일이 없으면 새로 만드세요.
powershell
$f = "$env:USERPROFILE\.config\opencode\opencode.json" md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f
API 키를 자동 입력하려면 로그인하세요

파일 내용 교체

UnoRouter 공급자 블록을 설정에 추가합니다. 기존 파일에 병합하고 이미 사용 중인 mcp 또는 agent 블록은 그대로 두세요.

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "unorouter-live": {
      "name": "UnoRouter",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "YOUR_API_KEY",
        "baseURL": "https://api.unorouter.com/v1"
      },
      "models": {
        "ling-3.0-flash-fin:free": {},
        "glm-5.3-flash-search:free": {},
        "glm-5.3-flash-think-search:free": {},
        "glm-5.3-flash-thinking:free": {},
        "glm-5.3-flash:free": {}
      }
    }
  }
}

API 키를 자동 입력하려면 로그인하세요

3
모델이 로드되는지 확인
파일을 저장한 뒤 터미널에서 opencode models 를 실행하세요. 나열한 모든 id 가 공급자 키를 접두사로 하여 표시되어야 합니다.
bash
opencode models
API 키를 자동 입력하려면 로그인하세요
4
모델 선택
모델 선택기를 열고 새 모델로 바꾸세요. 어댑터가 스트리밍과 도구 호출을 처리합니다.

주의사항

OpenCode 에는 OpenAI 호환 공급자를 위한 실시간 모델 탐색 기능이 없습니다. 사용할 모델은 모두 정확한 id 로 "models" 블록에 적어야 합니다.
공급자 키 이름을 "unorouter" 로만 두지 마세요. 해당 id 는 models.dev 레지스트리에 이미 있어서 OpenCode 가 사용자의 목록 대신 레지스트리 목록을 사용하고, 최신 모델이 누락됩니다. 위의 "-live" 접미사가 충돌을 피해 줍니다.
UnoRouter 카탈로그의 정확한 모델 id 를 사용하세요. 복사하며 붙은 공급자 접두사는 지우고, id 에 :free 접미사가 있으면 그대로 유지하세요.
"models" 블록이 없는 사용자 지정 공급자 키는 모델을 하나도 불러오지 못하므로, 공급자가 선택 목록에서 완전히 사라집니다.

API 키 생성 모델

OpenCode 설정 가이드

개요

빠른 설정

호환성

단계별 설정

추천 모델

주의사항