전체 가이드

오픈소스OpenAI 호환opencode

opencode

어떤 제공업체와도 동작하는 오픈소스 터미널 에이전트.

opencode는 OPENAI_BASE_URL을 읽지 않고 각 제공업체를 베이스 URL로 설정합니다. 가장 빠른 방법은 대화식 로그인이며, 세밀하게 제어하려면 설정 파일을 편집하세요.

공식 문서

설정 단계

  1. 1

    opencode 설치

    Node.js 18 이상이 필요합니다. 전역 명령 opencode가 설치됩니다.

    bash
    npm install -g opencode-ai
  2. 2

    방법 A: 빠른 로그인

    로그인 명령을 실행하고 「Other」까지 스크롤한 뒤 베이스 URL과 API 키를 붙여넣으세요.

    bash
    opencode auth login
  3. 3

    방법 B: 설정 파일

    OpenAI 호환 제공업체를 베이스 URL, 키, 모델과 함께 선언하세요. 값은 자신의 것으로 바꾸세요.

    ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "custom": {
          "npm": "@ai-sdk/openai-compatible",
          "options": {
            "baseURL": "https://api.example.com/v1",
            "apiKey": "your-api-key"
          },
          "models": { "your-model-name": {} }
        }
      }
    }
  4. 4

    코딩 시작

    프로젝트 폴더에서 실행하고 /models 명령으로 커스텀 모델을 선택하세요.

    bash
    opencode
팁: opencode는 커스텀 엔드포인트에 대해 OPENAI_BASE_URL이나 OPENAI_API_KEY를 읽지 않습니다. auth login이나 설정 파일로 제공업체를 반드시 선언해야 합니다.
먼저 더 저렴한 모델이나 제공업체를 고른 뒤, 그 키와 엔드포인트를 위 단계에 넣으세요. 가격 비교 · 제공업체 보기