OpenCode

OpenCode custom provider를 추가하고 자격 증명과 모델을 선택합니다.

설치 및 준비

  1. Node.js와 npm을 준비한 뒤 아래 공식 npm 패키지로 OpenCode를 설치하고 opencode --version을 실행합니다.
  2. API 키에서 routerra.ai 키를 만들고 모델에서 허용된 ID를 복사합니다. 예제는 Chat Completions를 사용하며 코딩 작업에는 도구 호출 지원이 필요합니다.
npm install -g opencode-ai
opencode --version

routerra 등록 및 연결

  1. 프로젝트 루트의 opencode.json을 만들거나 병합합니다. 전체 프로젝트에 적용하려면 ~/.config/opencode/opencode.json을 사용합니다. 모든 YOUR_MODEL_ID를 같은 값으로 바꿉니다. routerra/는 OpenCode provider 접두사이며 업스트림 모델 ID의 일부가 아닙니다.
  2. opencode에서 /connect → Other를 선택하고 provider ID routerra와 키를 입력합니다. ID는 JSON 키와 정확히 일치해야 합니다. 자격 증명은 ~/.local/share/opencode/auth.json에 별도 저장됩니다. /models로 모델을 선택하고 설정 파일 수정 후 다시 시작합니다.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "routerra/YOUR_MODEL_ID",
  "provider": {
    "routerra": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "routerra.ai",
      "options": { "baseURL": "https://routerra.ai/v1" },
      "models": { "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" } }
    }
  }
}

연결 확인

provider가 없으면 프로젝트/전역 설정 중 무엇이 로드됐는지와 provider.routerra.models를 확인합니다. 다른 /connect ID로 저장한 키로는 인증할 수 없습니다. /responses 전용 모델은 npm을 @ai-sdk/openai로 바꿉니다. 예제의 @ai-sdk/openai-compatible은 /chat/completions를 호출합니다. 짧은 답변과 읽기 전용 파일 조회를 시험하고 routerra.ai 사용량에서 모델을 확인합니다.