문제 해결 · opencode
opencode Model Not Found — 커스텀 프로바이더 모델 선언 방법
opencode는 자신이 아는 모델만 제공하며, 커스텀 프로바이더 모델은 models.dev 카탈로그에 없습니다. opencode.json에 모델을 선언해 표시되고 작동하게 만드는 방법.
표시되는 내용
opencode model not found발생 원인
- 모델이 프로바이더의 models 맵에 선언되어 있지 않고, 커스텀 프로바이더 모델은 opencode가 참조하는 models.dev 카탈로그에도 없습니다 — 그래서 그 모델은 아예 제공되지 않습니다.
- 선언된 모델 id가 엔드포인트가 서비스하는 것과 맞지 않습니다 — 오타나 퇴역한 id는 프로바이더의 404를 반환합니다.
- 모델은 opencode.json에 추가됐지만 opencode를 재시작하지 않아 예전 설정이 여전히 활성 상태입니다.
해결 방법
- 각 모델을 opencode.json의 프로바이더 models 맵에 명시적으로 선언하고, id는 엔드포인트가 서비스하는 것과 정확히 일치시키세요.
- id를 추측하지 말고 GET /v1/models로 엔드포인트의 실제 모델을 나열하세요.
- 변경 후 opencode를 재시작하세요.
모델을 명시적으로 선언하기
{
"provider": {
"apitoken": {
"npm": "@ai-sdk/openai-compatible",
"name": "apiToken.sale",
"options": {
"baseURL": "https://openai.api.apitoken.sale/v1",
"apiKey": "{env:APITOKEN_API_KEY}"
},
"models": {
"gpt-5.6-sol": { "name": "GPT-5.6 Sol" }
}
}
}
}관련 검색어
ModelNotFoundErroropencode custom provider model missing
자주 묻는 질문
커스텀 프로바이더의 모델이 왜 opencode에 나타나지 않나요?+
models.dev 카탈로그 밖의 모델은 프로바이더의 models 맵에 직접 선언해야 합니다. 선언되지 않은 모델은 아예 제공되지 않습니다.
선언할 정확한 모델 id를 어떻게 찾나요?+
당신의 키로 프로바이더의 GET /v1/models를 조회해 id를 그대로 복사하세요.
모델은 선언했는데 요청이 404입니다 — 또 무엇이 있나요?+
opencode.json의 id는 엔드포인트의 id와 글자 하나까지 일치해야 하고, baseURL은 문서화된 값이어야 합니다. 둘 다 확인한 뒤 opencode를 재시작하세요.