OpenCode
OpenCode 연결 또는 404 오류를 해결하는 방법
먼저 요청이 서비스에 도달할 수 있는지 확인한 다음, Base URL과 어댑터 조합을 점검하세요.
다음 검사부터 시작하세요
요청이 예상한 AI Code With 엔드포인트에 도달하지 못했습니다.
- 요청 시간이 초과되거나 ECONNREFUSED 또는 404가 반환되거나 응답이 없습니다.
- Base URL이 불완전하거나 추가 경로가 있습니다
- Base URL을 생성된 구성과 비교하세요
ECONNREFUSEDtimeout01
연결 실패와 HTTP 응답을 구분하세요
시간 초과 또는 ECONNREFUSED는 보통 요청이 도착하지 않았음을 의미하고, 404는 서비스가 일치하지 않는 경로를 수신했음을 의미합니다.
02
Base URL과 어댑터 확인
프로젝트 구성의 Base URL만 사용하세요. 기억에 의존해 /v1을 추가하거나 제거하지 말고, 어댑터를 Provider와 일치시키세요.
- 1Base URL을 생성된 구성과 비교하세요
- 2검증되지 않은 경로를 수동으로 추가하지 마세요
03
요청 경로 확인
상태 코드를 유지한 채 OpenCode를 다시 열고 재시도하세요. 서비스 응답이 오면 네트워크 경로가 작동함을 확인할 수 있습니다.
- 1검증되지 않은 경로를 수동으로 추가하지 마세요
- 2OpenCode를 다시 열고 재시도하세요
그래도 해결되지 않으면
출처
다시 구성
통합 센터로 돌아가 설정 단계를 계속하세요.
관련 설정 단계로 돌아가기Related problems
유효하지 않은 API Key 또는 401 · 모델이 /models에 없거나 Model Not Found · 모델은 목록에 있지만 요청이 완료되지 않음 · opencode 명령을 찾을 수 없음 · 속도 제한 또는 429 · 사용량은 기록되지만 OpenCode에서 응답이 표시되지 않음 · reasoning part/text part not found 또는 summaryParts 파싱 오류 · 유효하지 않은 opencode.json · 403 Forbidden · BunInstallFailedError 또는 models.dev 다운로드 실패