한국어
문서
프로바이더

프로바이더

OpenCode는 AI SDK와 Models.dev를 통해 75개 이상의 LLM 프로바이더를 지원하며, 다양한 언어 모델 서비스와 로컬 모델과의 통합을 가능하게 합니다.

설정 과정

  1. /connect 명령어로 API 키 추가
  2. OpenCode 설정에서 프로바이더 구성
  3. 인증 정보는 ~/.local/share/opencode/auth.json에 저장됨

기본 URL 설정

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.anthropic.com/v1"
      }
    }
  }
}

OpenCode Zen

OpenCode Zen은 OpenCode 팀에서 테스트하고 검증한 모델 목록입니다.

  1. /connect 실행, opencode 선택
  2. opencode.ai/auth에서 인증
  3. API 키 복사 및 붙여넣기
  4. /models로 권장 모델 보기

인기 프로바이더

Anthropic

  1. /connect 실행 후 Anthropic 선택
  2. 브라우저 인증을 위해 Claude Pro/Max 선택
  3. /models 명령어로 모델 접근

OpenAI

  1. platform.openai.com/api-keys에서 API 키 생성
  2. /connect 실행 후 OpenAI 검색
  3. API 키 입력
  4. /models로 모델 선택

OpenRouter

{
  "provider": {
    "openrouter": {
      "models": {
        "moonshotai/kimi-k2": {
          "options": {
            "provider": {
              "order": ["baseten"],
              "allow_fallbacks": false
            }
          }
        }
      }
    }
  }
}

Ollama (로컬)

{
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "llama2": {
          "name": "Llama 2"
        }
      }
    }
  }
}

LM Studio (로컬)

{
  "provider": {
    "lmstudio": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LM Studio (local)",
      "options": {
        "baseURL": "http://127.0.0.1:1234/v1"
      },
      "models": {
        "google/gemma-3n-e4b": {
          "name": "Gemma 3n-e4b (local)"
        }
      }
    }
  }
}

Amazon Bedrock

{
  "provider": {
    "amazon-bedrock": {
      "options": {
        "region": "us-east-1",
        "profile": "my-aws-profile"
      }
    }
  }
}

Azure OpenAI

  1. Azure 포털에서 Azure OpenAI 리소스 생성
  2. Azure AI Foundry에서 모델 배포
  3. /connect 실행 후 Azure 검색
  4. AZURE_RESOURCE_NAME 환경 변수 설정

사용자 정의 프로바이더 설정

OpenAI 호환 프로바이더의 경우:

{
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My AI Provider",
      "options": {
        "baseURL": "https://api.myprovider.com/v1",
        "apiKey": "{env:MY_API_KEY}"
      },
      "models": {
        "my-model": {
          "name": "My Model",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        }
      }
    }
  }
}

문제 해결

  1. 인증 확인: opencode auth list 실행으로 인증 정보 확인
  2. 사용자 정의 프로바이더 문제:
    • /connect와 설정 간 프로바이더 ID 일치 확인
    • 올바른 npm 패키지 확인
    • options.baseURL의 API 엔드포인트 확인
설정네트워크