OpenCode 연동
OpenCode에서 마인드로직 운영 Gateway의 AI 모델을 사용하는 방법을 안내합니다.
opencode.json 설정 파일 하나만 수정하면 모든 Gateway 모델에 바로 접근할 수 있습니다.- 공식 레퍼런스: OpenCode Providers
시작하기 전에 마인드로직 운영 API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.
설정
프로젝트 루트에
opencode.json을 생성하거나 업데이트합니다:API 키를 설정합니다:
주요 형식 세부사항
| 필드 | 값 |
|---|---|
npm | "@ai-sdk/openai-compatible" |
options.baseURL | Gateway Base URL (후행 슬래시 없음) |
options.apiKey | API 키, 또는 환경 변수용 "{env:VAR_NAME}" |
models.*.limit.context | 최대 입력 토큰 |
models.*.limit.output | 최대 출력 토큰 |
모델 선택
OpenCode 내에서
/model로 모델을 전환합니다:/model factchat/claude-opus-5
/model factchat/gpt-6-astra
/model factchat/gemini-3.8-flash
참고
- OpenCode는 OpenAI 호환
/chat/completions/엔드포인트를 사용합니다 - 모델 ID는
GET /v1/gateway/models/에서 반환되는 것과 정확히 일치해야 합니다 limit값은 컨텍스트 관리를 위한 힌트이며, 하드 리밋이 아닙니다
마지막 수정 날짜: Sep 09, 2026