한국어
문서
프로바이더

프로바이더

OpenCode에서 모든 LLM 프로바이더 사용하기.

OpenCode는 AI SDK (opens in a new tab)와 Models.dev (opens in a new tab)를 사용하여 75개 이상의 LLM 프로바이더를 지원하며 로컬 모델 실행도 지원합니다.

프로바이더를 추가하려면 다음을 해야 합니다:

  1. /connect 명령을 사용하여 프로바이더의 API 키를 추가합니다.
  2. OpenCode 설정에서 프로바이더를 구성합니다.

자격 증명

/connect 명령으로 프로바이더의 API 키를 추가하면, ~/.local/share/opencode/auth.json에 저장됩니다.

설정

OpenCode 설정의 provider 섹션을 통해 프로바이더를 사용자 정의할 수 있습니다.

Base URL

baseURL 옵션을 설정하여 모든 프로바이더의 base URL을 사용자 정의할 수 있습니다. 이는 프록시 서비스나 사용자 정의 엔드포인트를 사용할 때 유용합니다.

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

OpenCode Zen

OpenCode Zen은 OpenCode와 잘 작동하도록 테스트되고 검증된, OpenCode 팀이 제공하는 모델 목록입니다. 자세히 알아보기.

팁: 처음이라면 OpenCode Zen으로 시작하는 것을 권장합니다.

  1. TUI에서 /connect 명령을 실행하고, OpenCode Zen을 선택한 다음 opencode.ai/auth (opens in a new tab)로 이동하세요.

    /connect

  2. 로그인하고, 결제 정보를 추가한 다음, API 키를 복사하세요.

  3. API 키를 붙여넣으세요.

    ┌ API key
│
│
└ enter

  4. TUI에서 /models를 실행하여 권장 모델 목록을 확인하세요.

    /models

OpenCode의 다른 프로바이더와 동일하게 작동하며, 사용은 완전히 선택 사항입니다.

OpenCode Go

OpenCode Go는 OpenCode와 잘 작동하도록 테스트되고 검증된, OpenCode 팀이 제공하는 인기 오픈 코딩 모델에 대한 안정적인 액세스를 제공하는 저비용 구독 요금제입니다.

  1. TUI에서 /connect 명령을 실행하고, OpenCode Go를 선택한 다음 opencode.ai/auth (opens in a new tab)로 이동하세요.

    /connect

  2. 로그인하고, 결제 정보를 추가한 다음, API 키를 복사하세요.

  3. API 키를 붙여넣으세요.

    ┌ API key
│
│
└ enter

  4. TUI에서 /models를 실행하여 권장 모델 목록을 확인하세요.

    /models

OpenCode의 다른 프로바이더와 동일하게 작동하며, 사용은 완전히 선택 사항입니다.

디렉터리

일부 프로바이더를 자세히 살펴보겠습니다. 목록에 프로바이더를 추가하고 싶다면, 자유롭게 PR을 여세요.

참고: 여기에 원하는 프로바이더가 없나요? PR을 제출하세요.

302.AI

  1. 302.AI 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 302.AI를 검색하세요.

    /connect

  3. 302.AI API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

Amazon Bedrock

OpenCode와 함께 Amazon Bedrock을 사용하려면:

  1. Amazon Bedrock 콘솔의 Model catalog로 이동하여 원하는 모델에 대한 액세스를 요청하세요.

    팁: Amazon Bedrock에서 원하는 모델에 대한 액세스 권한이 있어야 합니다.

  2. 다음 방법 중 하나를 사용하여 인증을 구성하세요:

    환경 변수 (빠른 시작)

    opencode를 실행하는 동안 다음 환경 변수 중 하나를 설정하세요:

    # Option 1: Using AWS access keys
AWS_ACCESS_KEY_ID=XXX AWS_SECRET_ACCESS_KEY=YYY opencode
 
# Option 2: Using named AWS profile
AWS_PROFILE=my-profile opencode
 
# Option 3: Using Bedrock bearer token
AWS_BEARER_TOKEN_BEDROCK=XXX opencode

    또는 bash 프로필에 추가하세요:

    ~/.bash_profile
    export AWS_PROFILE=my-dev-profile
export AWS_REGION=us-east-1

    구성 파일 (권장)

    프로젝트별 또는 영구 구성을 위해서는 opencode.json을 사용하세요:

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "amazon-bedrock": {
      "options": {
        "region": "us-east-1",
        "profile": "my-aws-profile"
      }
    }
  }
}

    사용 가능한 옵션:

    • region - AWS 리전 (예: us-east-1 , eu-west-1 )

    • profile - ~/.aws/credentials의 AWS 명명된 프로필

    • endpoint - VPC 엔드포인트용 사용자 정의 엔드포인트 URL (일반 baseURL 옵션의 별칭)

    팁: 구성 파일 옵션이 환경 변수보다 우선합니다.

    고급: VPC 엔드포인트

    Bedrock에 VPC 엔드포인트를 사용하는 경우:

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "amazon-bedrock": {
      "options": {
        "region": "us-east-1",
        "profile": "production",
        "endpoint": "https://bedrock-runtime.us-east-1.vpce-xxxxx.amazonaws.com"
      }
    }
  }
}

    참고: endpoint 옵션은 AWS 고유 용어를 사용하는 일반 baseURL 옵션의 별칭입니다. endpoint와 baseURL이 모두 지정된 경우, endpoint가 우선합니다.

    인증 방법

    • AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY : AWS 콘솔에서 IAM 사용자를 만들고 액세스 키를 생성하세요
    • AWS_PROFILE : ~/.aws/credentials의 명명된 프로필을 사용하세요. 먼저 aws configure --profile my-profile 또는 aws sso login으로 구성하세요
    • AWS_BEARER_TOKEN_BEDROCK : Amazon Bedrock 콘솔에서 장기 API 키를 생성하세요
    • AWS_WEB_IDENTITY_TOKEN_FILE / AWS_ROLE_ARN : EKS IRSA(IAM Roles for Service Accounts) 또는 OIDC 페더레이션을 사용하는 다른 Kubernetes 환경용입니다. 이 환경 변수들은 서비스 계정 어노테이션을 사용할 때 Kubernetes에 의해 자동으로 주입됩니다.

    인증 우선순위

    Amazon Bedrock은 다음 인증 우선순위를 사용합니다:

    1. Bearer Token - AWS_BEARER_TOKEN_BEDROCK 환경 변수 또는 /connect 명령의 토큰

    2. AWS Credential Chain - 프로필, 액세스 키, 공유 자격 증명, IAM 역할, Web Identity Token(EKS IRSA), 인스턴스 메타데이터

    참고: Bearer 토큰이 설정되면(/connect 또는 AWS_BEARER_TOKEN_BEDROCK을 통해), 구성된 프로필을 포함한 모든 AWS 자격 증명 방법보다 우선합니다.

  3. /models 명령을 실행하여 원하는 모델을 선택하세요.

    /models

참고: 사용자 정의 추론 프로필의 경우, 키에 모델 및 프로바이더 이름을 사용하고 id 속성을 arn으로 설정하세요. 이를 통해 올바른 캐싱이 보장됩니다.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "amazon-bedrock": {
      // ...
      "models": {
        "anthropic-claude-sonnet-4.5": {
          "id": "arn:aws:bedrock:us-east-1:xxx:application-inference-profile/yyy"
        }
      }
    }
  }
}

Anthropic

  1. 가입한 후, /connect 명령을 실행하고 Anthropic을 선택하세요.

    /connect

  2. 여기서 Claude Pro/Max 옵션을 선택하면 브라우저가 열리고 인증을 요청합니다.

    ┌ Select auth method
│
│ Manually enter API Key
└

  3. 이제 /models 명령을 사용할 때 모든 Anthropic 모델을 사용할 수 있습니다.

    /models

Claude Pro/Max 모델을 OpenCode와 함께 사용할 수 있게 해주는 플러그인들이 있습니다. Anthropic은 이를 명시적으로 금지합니다.

이전 버전의 OpenCode에는 이 플러그인들이 번들로 포함되어 있었지만, 1.3.0부터는 더 이상 그렇지 않습니다.

다른 회사들은 개발자 도구에서 선택의 자유를 지원합니다 - 다음 구독을 OpenCode에서 설정 없이 사용할 수 있습니다:

  • ChatGPT Plus
  • Github Copilot
  • Gitlab Duo

Atomic Chat

Atomic Chat (opens in a new tab)을 통해 로컬 모델을 사용하도록 opencode를 구성할 수 있습니다. 이는 OpenAI 호환 API 서버(기본 엔드포인트 http://127.0.0.1:1337/v1) 뒤에서 로컬 LLM을 실행하는 데스크톱 애플리케이션입니다.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "atomic-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Atomic Chat (local)",
      "options": {
        "baseURL": "http://127.0.0.1:1337/v1"
      },
      "models": {
        "<your-model-id>": {
          "name": "<your-model-name>"
        }
      }
    }
  }
}

이 예시에서:

  • atomic-chat은 사용자 정의 프로바이더 ID입니다. 원하는 어떤 문자열이든 될 수 있습니다.
  • npm은 이 프로바이더에 사용할 패키지를 지정합니다. 여기서는 모든 OpenAI 호환 API에 @ai-sdk/openai-compatible이 사용됩니다.
  • name은 UI에 표시되는 프로바이더의 표시 이름입니다.
  • options.baseURL은 로컬 서버의 엔드포인트입니다. Atomic Chat 설정에 맞게 호스트와 포트를 변경하세요.
  • models는 모델 ID와 표시 이름을 매핑한 것입니다. 각 ID는 GET /v1/models가 반환하는 id와 일치해야 합니다 — curl http://127.0.0.1:1337/v1/models를 실행하여 현재 Atomic Chat에 로드된 ID를 확인하세요.

팁: 도구 호출이 제대로 작동하지 않으면, 도구 호출 지원이 강력한 로드된 모델(예: Qwen-Coder 또는 DeepSeek-Coder 변형)을 선택하세요.

Azure OpenAI

참고: "I'm sorry, but I cannot assist with that request" 오류가 발생하면, Azure 리소스의 콘텐츠 필터를 DefaultV2에서 Default로 변경해 보세요.

  1. Azure 포털 (opens in a new tab)로 이동하여 Azure OpenAI 리소스를 만드세요. 다음이 필요합니다:

    • Resource name : 이는 API 엔드포인트의 일부가 됩니다 ( https://RESOURCE_NAME.openai.azure.com/ )
    • API key : 리소스의 KEY 1 또는 KEY 2

  2. Azure AI Foundry (opens in a new tab)로 이동하여 모델을 배포하세요.

    참고: opencode가 제대로 작동하려면 배포 이름이 모델 이름과 일치해야 합니다.

  3. /connect 명령을 실행하고 Azure를 검색하세요.

    /connect

  4. API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  5. 리소스 이름을 환경 변수로 설정하세요:

    AZURE_RESOURCE_NAME=XXX opencode

    또는 bash 프로필에 추가하세요:

    ~/.bash_profile
    export AZURE_RESOURCE_NAME=XXX

  6. /models 명령을 실행하여 배포된 모델을 선택하세요.

    /models

Azure Cognitive Services

  1. Azure 포털 (opens in a new tab)로 이동하여 Azure OpenAI 리소스를 만드세요. 다음이 필요합니다:

    • Resource name : 이는 API 엔드포인트의 일부가 됩니다 ( https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/ )
    • API key : 리소스의 KEY 1 또는 KEY 2

  2. Azure AI Foundry (opens in a new tab)로 이동하여 모델을 배포하세요.

    참고: opencode가 제대로 작동하려면 배포 이름이 모델 이름과 일치해야 합니다.

  3. /connect 명령을 실행하고 Azure Cognitive Services를 검색하세요.

    /connect

  4. API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  5. 리소스 이름을 환경 변수로 설정하세요:

    AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX opencode

    또는 bash 프로필에 추가하세요:

    ~/.bash_profile
    export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX

  6. /models 명령을 실행하여 배포된 모델을 선택하세요.

    /models

Baseten

  1. Baseten (opens in a new tab)으로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 Baseten을 검색하세요.

    /connect

  3. Baseten API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

Cerebras

  1. Cerebras 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 Cerebras를 검색하세요.

    /connect

  3. Cerebras API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Qwen 3 Coder 480B 같은 모델을 선택하세요.

    /models

Cloudflare AI Gateway

Cloudflare AI Gateway를 사용하면 통합 엔드포인트를 통해 OpenAI, Anthropic, Workers AI 등의 모델에 액세스할 수 있습니다. 통합 결제 (opens in a new tab)를 사용하면 각 프로바이더마다 별도의 API 키가 필요하지 않습니다.

  1. Cloudflare 대시보드 (opens in a new tab)로 이동하여, AI > AI Gateway로 이동한 다음, 새 게이트웨이를 만드세요. Account ID와 Gateway ID를 메모해 두세요.

  2. /connect 명령을 실행하고 Cloudflare AI Gateway를 검색하세요.

    /connect

  3. 메시지가 표시되면 Account ID를 입력하세요.

    ┌ Enter your Cloudflare Account ID
│
│
└ enter

  4. 메시지가 표시되면 Gateway ID를 입력하세요.

    ┌ Enter your Cloudflare AI Gateway ID
│
│
└ enter

  5. Cloudflare API token을 입력하세요.

    ┌ Gateway API token
│
│
└ enter

  6. /models 명령을 실행하여 모델을 선택하세요.

    /models

    opencode 설정을 통해 모델을 추가할 수도 있습니다.

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cloudflare-ai-gateway": {
      "models": {
        "openai/gpt-4o": {},
        "anthropic/claude-sonnet-4": {}
      }
    }
  }
}

    또는 /connect 대신 환경 변수를 설정할 수도 있습니다.

    ~/.bash_profile
    export CLOUDFLARE_ACCOUNT_ID=your-32-character-account-id
export CLOUDFLARE_GATEWAY_ID=your-gateway-id
export CLOUDFLARE_API_TOKEN=your-api-token

Cloudflare Workers AI

Cloudflare Workers AI를 사용하면 REST API를 통해 Cloudflare의 글로벌 네트워크에서 직접 AI 모델을 실행할 수 있으며, 지원되는 모델에 대해 별도의 프로바이더 계정이 필요하지 않습니다.

  1. Cloudflare 대시보드 (opens in a new tab)로 이동하여, Workers AI로 이동한 다음, Use REST API를 선택하여 Account ID를 얻고 API 토큰을 만드세요.

  2. /connect 명령을 실행하고 Cloudflare Workers AI를 검색하세요.

    /connect

  3. 메시지가 표시되면 Account ID를 입력하세요.

    ┌ Enter your Cloudflare Account ID
│
│
└ enter

  4. Cloudflare API key를 입력하세요.

    ┌ API key
│
│
└ enter

  5. /models 명령을 실행하여 모델을 선택하세요.

    /models

    또는 /connect 대신 환경 변수를 설정할 수도 있습니다.

    ~/.bash_profile
    export CLOUDFLARE_ACCOUNT_ID=your-32-character-account-id
export CLOUDFLARE_API_KEY=your-api-token

Cortecs

  1. Cortecs 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 Cortecs를 검색하세요.

    /connect

  3. Cortecs API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Kimi K2 Instruct 같은 모델을 선택하세요.

    /models

DeepSeek

  1. DeepSeek 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, Create new API key를 클릭하세요.

  2. /connect 명령을 실행하고 DeepSeek을 검색하세요.

    /connect

  3. DeepSeek API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 DeepSeek V4 Pro 같은 DeepSeek 모델을 선택하세요.

    /models

Deep Infra

  1. Deep Infra 대시보드 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 Deep Infra를 검색하세요.

    /connect

  3. Deep Infra API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

DigitalOcean

DigitalOcean의 Inference Engine (opens in a new tab)은 GPT-OSS, Llama, Qwen, DeepSeek 같은 오픈 모델에 대한 액세스를 제공하며, 각 요청을 작업에 가장 저렴하거나 빠르거나 가장 적합한 모델로 라우팅하는 사용자 정의 Inference Routers (opens in a new tab)도 제공합니다.

OpenCode는 두 가지 인증 방법을 지원합니다:

  • OAuth (권장) — DigitalOcean 계정에 로그인하면, OpenCode가 Model Access Key를 자동으로 생성하고 사용 가능한 Models 및 Inference Routers를 검색합니다.
  • Model Access Key — DigitalOcean 콘솔에서 기존 키를 붙여넣습니다.

OAuth (권장)

  1. /connect 명령을 실행하고 DigitalOcean을 검색하세요.

    /connect

  2. Login with DigitalOcean을 선택하세요.

    ┌ Select auth method
│
│ Login with DigitalOcean
│ Paste Model Access Key
└

  3. 브라우저가 열려 OpenCode를 승인합니다. 로그인하고 승인하세요.

    참고: OpenCode는 DigitalOcean 계정에 opencode-oauth-<timestamp>라는 이름의 Model Access Key를 생성합니다. DigitalOcean 콘솔의 Inference 아래 "Manage" 섹션에 있는 Model Access Keys 페이지에서 이를 교체하거나 취소할 수 있습니다.

  4. /models 명령을 실행하세요. Inference Routers는 모델 선택에서 router: 형식으로 나타납니다.

    /models

  5. 새로 생성된 Inference Routers를 가져오려면, /connect를 다시 실행하고 DigitalOcean을 다시 선택하세요.

Model Access Key 사용

키를 직접 붙여넣는 것을 선호한다면:

  1. DigitalOcean 콘솔 (opens in a new tab)의 Inference 섹션에 있는 Manage 페이지로 이동하여 새 키를 만드세요.

  2. /connect 명령을 실행하고 DigitalOcean을 선택한 다음, Paste Model Access Key를 선택하세요.

    ┌ Enter your DigitalOcean Model Access Key
│
│
└ enter

    참고: 이 방법으로는 Inference Routers가 자동으로 검색되지 않습니다. 모델 선택기에서 이를 표시하려면, 대신 OAuth로 로그인하세요.

  3. /models 명령을 실행하여 모델을 선택하세요.

    /models

환경 변수

또는 Model Access Key를 환경 변수로 설정하세요.

export DIGITALOCEAN_ACCESS_TOKEN=your-model-access-key

Inference Routers

Inference Routers를 사용하면 여러 모델에 걸친 라우팅 정책을 정의할 수 있습니다 — 작업에 따라 요청별로 가장 저렴하거나 빠르거나 가장 적합한 모델을 선택합니다. OAuth 후, OpenCode는 각 라우터를 모델 선택기에 router:<router-name>으로 표시합니다.

라우터 모델을 선택하는 것은 다른 모든 모델을 대체하는 드롭인 방식입니다 — OpenCode가 요청을 전달하고 DigitalOcean이 라우터의 정책에 따라 기본 모델을 선택합니다. Inference Routers (opens in a new tab)에 대해 자세히 알아보세요

FrogBot

  1. FrogBot 대시보드 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 FrogBot을 검색하세요.

    /connect

  3. FrogBot API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

Fireworks AI

  1. Fireworks AI 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, Create API Key를 클릭하세요.

  2. /connect 명령을 실행하고 Fireworks AI를 검색하세요.

    /connect

  3. Fireworks AI API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Kimi K2 Instruct 같은 모델을 선택하세요.

    /models

GitLab Duo

주의: OpenCode의 GitLab Duo 지원은 실험적입니다. 기능, 구성 및 동작은 향후 릴리스에서 변경될 수 있습니다.

OpenCode는 GitLab Duo Agent Platform (opens in a new tab)과 통합되어, 네이티브 도구 호출 기능을 갖춘 AI 기반 에이전트 채팅을 제공합니다.

참고: GitLab Duo Agent Platform은 Premium 또는 Ultimate GitLab 구독이 필요합니다. GitLab.com 및 GitLab Self-Managed에서 사용할 수 있습니다. 전체 요구 사항은 GitLab Duo Agent Platform 사전 요구 사항 (opens in a new tab)을 참조하세요.

  1. /connect 명령을 실행하고 GitLab을 선택하세요.

    /connect

  2. 인증 방법을 선택하세요:

    ┌ Select auth method
│
│ OAuth (Recommended)
│ Personal Access Token
└

    OAuth 사용 (권장)

    OAuth를 선택하면 브라우저가 열려 승인합니다.

    Personal Access Token 사용

    1. GitLab User Settings > Access Tokens (opens in a new tab)로 이동하세요
    2. Add new token을 클릭하세요
    3. Name: OpenCode , Scopes: api
    4. 토큰을 복사하세요 ( glpat-로 시작 )
    5. 터미널에 입력하세요

  3. /models 명령을 실행하여 사용 가능한 모델을 확인하세요.

    /models

    세 가지 Claude 기반 모델을 사용할 수 있습니다:

    • duo-chat-haiku-4-5 (기본값) - 빠른 작업을 위한 빠른 응답
    • duo-chat-sonnet-4-5 - 대부분의 워크플로우를 위한 균형 잡힌 성능
    • duo-chat-opus-4-5 - 복잡한 분석에 가장 강력함

참고: opencode auth 스토리지에 토큰을 저장하고 싶지 않다면 'GITLAB_TOKEN' 환경 변수를 지정할 수도 있습니다.

Self-Hosted GitLab

참고: OpenCode는 세션 제목 생성 같은 일부 AI 작업에 작은 모델을 사용합니다. 기본적으로 Zen이 호스팅하는 gpt-5-nano를 사용하도록 구성되어 있습니다. OpenCode가 자체 GitLab 호스팅 인스턴스만 사용하도록 잠그려면, opencode.json 파일에 다음을 추가하세요. 또한 세션 공유를 비활성화하는 것이 권장됩니다.

{
  "$schema": "https://opencode.ai/config.json",
  "small_model": "gitlab/duo-chat-haiku-4-5",
  "share": "disabled"
}

자체 호스팅 GitLab 인스턴스의 경우:

export GITLAB_INSTANCE_URL=https://gitlab.company.com
export GITLAB_TOKEN=glpat-...

인스턴스가 사용자 정의 AI Gateway를 실행하는 경우:

GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com

또는 bash 프로필에 추가하세요:

~/.bash_profile
export GITLAB_INSTANCE_URL=https://gitlab.company.com
export GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com
export GITLAB_TOKEN=glpat-...

참고: GitLab 관리자는 다음을 해야 합니다:

  1. 사용자, 그룹 또는 인스턴스에 대해 GitLab Duo 켜기 (opens in a new tab)
  2. Agent Platform 켜기 (opens in a new tab) (GitLab 18.8+) 또는 베타 및 실험적 기능 활성화 (opens in a new tab) (GitLab 18.7 이하)
  3. Self-Managed의 경우, 인스턴스 구성 (opens in a new tab)
Self-Hosted 인스턴스를 위한 OAuth

자체 호스팅 인스턴스에서 OAuth를 작동시키려면, 콜백 URL http://127.0.0.1:8080/callback과 다음 스코프로 새 애플리케이션(Settings → Applications)을 만들어야 합니다:

  • api (Access the API on your behalf)
  • read_user (Read your personal information)
  • read_repository (Allows read-only access to the repository)

그런 다음 애플리케이션 ID를 환경 변수로 노출하세요:

export GITLAB_OAUTH_CLIENT_ID=your_application_id_here

opencode-gitlab-auth (opens in a new tab) 홈페이지에 더 많은 문서가 있습니다.

구성

opencode.json을 통해 사용자 정의하세요:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gitlab": {
      "options": {
        "instanceUrl": "https://gitlab.com"
      }
    }
  }
}
GitLab Duo Agent Platform (DAP) Workflow Models

DAP workflow 모델은 표준 에이전트 채팅 대신 GitLab의 Duo Workflow Service(DWS)를 통해 도구 호출을 라우팅하는 대체 실행 경로를 제공합니다. duo-workflow-* 모델이 선택되면, OpenCode는 다음을 수행합니다:

  1. GitLab 네임스페이스에서 사용 가능한 모델 검색
  2. 여러 모델을 사용할 수 있는 경우 선택 선택기 표시
  3. 빠른 후속 시작을 위해 선택한 모델을 디스크에 캐시
  4. OpenCode의 권한 게이트 도구 시스템을 통해 도구 실행 요청 라우팅

사용 가능한 DAP workflow 모델은 duo-workflow-* 명명 규칙을 따르며 GitLab 인스턴스에서 동적으로 검색됩니다.

GitLab API Tools (선택 사항이지만 적극 권장)

GitLab 도구(병합 요청, 이슈, 파이프라인, CI/CD 등)에 액세스하려면:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-gitlab-plugin"]
}

이 플러그인은 MR 리뷰, 이슈 추적, 파이프라인 모니터링 등을 포함한 포괄적인 GitLab 저장소 관리 기능을 제공합니다.

GitHub Copilot

opencode와 함께 GitHub Copilot 구독을 사용하려면:

참고: 일부 모델은 사용하기 위해 Pro+ 구독 (opens in a new tab)이 필요할 수 있습니다.

  1. /connect 명령을 실행하고 GitHub Copilot을 검색하세요.

    /connect

  2. github.com/login/device (opens in a new tab)로 이동하여 코드를 입력하세요.

    ┌ Login with GitHub Copilot
│
│ https://github.com/login/device
│
│ Enter code: 8F43-6FCF
│
└ Waiting for authorization...

  3. 이제 /models 명령을 실행하여 원하는 모델을 선택하세요.

    /models

Google Vertex AI

OpenCode와 함께 Google Vertex AI를 사용하려면:

  1. Google Cloud Console의 Model Garden으로 이동하여 해당 리전에서 사용 가능한 모델을 확인하세요.

    참고: Vertex AI API가 활성화된 Google Cloud 프로젝트가 있어야 합니다.

  2. 필요한 환경 변수를 설정하세요:

    • GOOGLE_CLOUD_PROJECT : Google Cloud 프로젝트 ID

    • VERTEX_LOCATION (선택 사항): Vertex AI의 리전 (기본값 global )

    • 인증 (하나 선택):

      • GOOGLE_APPLICATION_CREDENTIALS : 서비스 계정 JSON 키 파일의 경로
      • gcloud CLI를 사용하여 인증: gcloud auth application-default login

    opencode를 실행하는 동안 설정하세요.

    GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode

    또는 bash 프로필에 추가하세요.

    ~/.bash_profile
    export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project-id
export VERTEX_LOCATION=global

팁: global 리전은 추가 비용 없이 가용성을 개선하고 오류를 줄입니다. 데이터 레지던시 요구 사항에는 리전 엔드포인트(예: us-central1)를 사용하세요. 자세히 알아보기 (opens in a new tab)

  1. /models 명령을 실행하여 원하는 모델을 선택하세요.

    /models

Groq

  1. Groq 콘솔 (opens in a new tab)로 이동하여, Create API Key를 클릭하고, 키를 복사하세요.

  2. /connect 명령을 실행하고 Groq을 검색하세요.

    /connect

  3. 프로바이더의 API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 원하는 것을 선택하세요.

    /models

Hugging Face

Hugging Face Inference Providers (opens in a new tab)는 17개 이상의 프로바이더가 지원하는 오픈 모델에 대한 액세스를 제공합니다.

  1. Hugging Face 설정 (opens in a new tab)으로 이동하여 Inference Providers를 호출할 권한이 있는 토큰을 만드세요.

  2. /connect 명령을 실행하고 Hugging Face를 검색하세요.

    /connect

  3. Hugging Face 토큰을 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Kimi-K2-Instruct 또는 GLM-4.6 같은 모델을 선택하세요.

    /models

Helicone

Helicone (opens in a new tab)은 AI 애플리케이션을 위한 로깅, 모니터링 및 분석을 제공하는 LLM 관찰성 플랫폼입니다. Helicone AI Gateway는 모델에 따라 요청을 적절한 프로바이더로 자동 라우팅합니다.

  1. Helicone (opens in a new tab)으로 이동하여, 계정을 만들고, 대시보드에서 API 키를 생성하세요.

  2. /connect 명령을 실행하고 Helicone을 검색하세요.

    /connect

  3. Helicone API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

더 많은 프로바이더와 캐싱 및 속도 제한 같은 고급 기능은 Helicone 문서 (opens in a new tab)를 확인하세요.

선택적 구성

opencode를 통해 자동으로 구성되지 않은 Helicone의 기능이나 모델을 발견한 경우, 언제든지 직접 구성할 수 있습니다.

다음은 Helicone의 Model Directory (opens in a new tab)입니다. 추가하려는 모델의 ID를 가져오려면 이것이 필요합니다.

~/.config/opencode/opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "helicone": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Helicone",
      "options": {
        "baseURL": "https://ai-gateway.helicone.ai",
      },
      "models": {
        "gpt-4o": {
          // Model ID (from Helicone's model directory page)
          "name": "GPT-4o", // Your own custom name for the model
        },
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
        },
      },
    },
  },
}

사용자 정의 헤더

Helicone은 캐싱, 사용자 추적 및 세션 관리 같은 기능을 위한 사용자 정의 헤더를 지원합니다. options.headers를 사용하여 프로바이더 구성에 추가하세요:

~/.config/opencode/opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "helicone": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Helicone",
      "options": {
        "baseURL": "https://ai-gateway.helicone.ai",
        "headers": {
          "Helicone-Cache-Enabled": "true",
          "Helicone-User-Id": "opencode",
        },
      },
    },
  },
}
세션 추적

Helicone의 Sessions (opens in a new tab) 기능을 사용하면 관련 LLM 요청을 그룹화할 수 있습니다. opencode-helicone-session (opens in a new tab) 플러그인을 사용하여 각 OpenCode 대화를 Helicone의 세션으로 자동 기록하세요.

npm install -g opencode-helicone-session

설정에 추가하세요.

opencode.json
{
  "plugin": ["opencode-helicone-session"]
}

이 플러그인은 요청에 Helicone-Session-Id와 Helicone-Session-Name 헤더를 주입합니다. Helicone의 Sessions 페이지에서 각 OpenCode 대화가 별도의 세션으로 나열되는 것을 볼 수 있습니다.

일반적인 Helicone 헤더
헤더설명
Helicone-Cache-Enabled응답 캐싱 활성화 (true/false)
Helicone-User-Id사용자별 메트릭 추적
Helicone-Property-[Name]사용자 정의 속성 추가 (예: Helicone-Property-Environment)
Helicone-Prompt-Id요청을 프롬프트 버전과 연결

사용 가능한 모든 헤더는 Helicone Header Directory (opens in a new tab)를 참조하세요.

llama.cpp

llama.cpp의 (opens in a new tab) llama-server 유틸리티를 통해 로컬 모델을 사용하도록 opencode를 구성할 수 있습니다

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "llama.cpp": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "llama-server (local)",
      "options": {
        "baseURL": "http://127.0.0.1:8080/v1"
      },
      "models": {
        "qwen3-coder:a3b": {
          "name": "Qwen3-Coder: a3b-30b (local)",
          "limit": {
            "context": 128000,
            "output": 65536
          }
        }
      }
    }
  }
}

이 예시에서:

  • llama.cpp는 사용자 정의 프로바이더 ID입니다. 원하는 어떤 문자열이든 될 수 있습니다.
  • npm은 이 프로바이더에 사용할 패키지를 지정합니다. 여기서는 모든 OpenAI 호환 API에 @ai-sdk/openai-compatible이 사용됩니다.
  • name은 UI에 표시되는 프로바이더의 표시 이름입니다.
  • options.baseURL은 로컬 서버의 엔드포인트입니다.
  • models는 모델 ID와 그 구성을 매핑한 것입니다. 모델 이름은 모델 선택 목록에 표시됩니다.

IO.NET

IO.NET은 다양한 사용 사례에 최적화된 17개의 모델을 제공합니다:

  1. IO.NET 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 IO.NET을 검색하세요.

    /connect

  3. IO.NET API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

LM Studio

LM Studio를 통해 로컬 모델을 사용하도록 opencode를 구성할 수 있습니다.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "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)"
        }
      }
    }
  }
}

이 예시에서:

  • lmstudio는 사용자 정의 프로바이더 ID입니다. 원하는 어떤 문자열이든 될 수 있습니다.
  • npm은 이 프로바이더에 사용할 패키지를 지정합니다. 여기서는 모든 OpenAI 호환 API에 @ai-sdk/openai-compatible이 사용됩니다.
  • name은 UI에 표시되는 프로바이더의 표시 이름입니다.
  • options.baseURL은 로컬 서버의 엔드포인트입니다.
  • models는 모델 ID와 그 구성을 매핑한 것입니다. 모델 이름은 모델 선택 목록에 표시됩니다.

Moonshot AI

Moonshot AI의 Kimi K2를 사용하려면:

  1. Moonshot AI 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, Create API key를 클릭하세요.

  2. /connect 명령을 실행하고 Moonshot AI를 검색하세요.

    /connect

  3. Moonshot API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Kimi K2를 선택하세요.

    /models

MiniMax

  1. MiniMax API 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 MiniMax를 검색하세요.

    /connect

  3. MiniMax API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 M2.1 같은 모델을 선택하세요.

    /models

NVIDIA

NVIDIA는 build.nvidia.com (opens in a new tab)을 통해 Nemotron 모델과 다른 많은 오픈 모델에 대한 무료 액세스를 제공합니다.

  1. build.nvidia.com (opens in a new tab)으로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 NVIDIA를 검색하세요.

    /connect

  3. NVIDIA API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 nemotron-3-super-120b-a12b 같은 모델을 선택하세요.

    /models

On-Prem / NIM

사용자 정의 base URL을 설정하여 NVIDIA NIM (opens in a new tab)을 통해 NVIDIA 모델을 로컬에서 사용할 수도 있습니다.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "nvidia": {
      "options": {
        "baseURL": "http://localhost:8000/v1"
      }
    }
  }
}

환경 변수

또는 API 키를 환경 변수로 설정하세요.

export NVIDIA_API_KEY=nvapi-your-key-here

Nebius Token Factory

  1. Nebius Token Factory 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, Add Key를 클릭하세요.

  2. /connect 명령을 실행하고 Nebius Token Factory를 검색하세요.

    /connect

  3. Nebius Token Factory API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Kimi K2 Instruct 같은 모델을 선택하세요.

    /models

Ollama

Ollama를 통해 로컬 모델을 사용하도록 opencode를 구성할 수 있습니다.

팁: Ollama는 OpenCode를 위해 자동으로 자체 구성할 수 있습니다. 자세한 내용은 Ollama 통합 문서 (opens in a new tab)를 참조하세요.

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

이 예시에서:

  • ollama는 사용자 정의 프로바이더 ID입니다. 원하는 어떤 문자열이든 될 수 있습니다.
  • npm은 이 프로바이더에 사용할 패키지를 지정합니다. 여기서는 모든 OpenAI 호환 API에 @ai-sdk/openai-compatible이 사용됩니다.
  • name은 UI에 표시되는 프로바이더의 표시 이름입니다.
  • options.baseURL은 로컬 서버의 엔드포인트입니다.
  • models는 모델 ID와 그 구성을 매핑한 것입니다. 모델 이름은 모델 선택 목록에 표시됩니다.

팁: 도구 호출이 작동하지 않으면, Ollama에서 num_ctx를 늘려 보세요. 16k - 32k 정도로 시작하세요.

Ollama Cloud

OpenCode와 함께 Ollama Cloud를 사용하려면:

  1. https://ollama.com/ (opens in a new tab)으로 이동하여 로그인하거나 계정을 만드세요.

  2. Settings > Keys로 이동하여 Add API Key를 클릭해 새 API 키를 생성하세요.

  3. OpenCode에서 사용할 API 키를 복사하세요.

  4. /connect 명령을 실행하고 Ollama Cloud를 검색하세요.

    /connect

  5. Ollama Cloud API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  6. 중요: OpenCode에서 클라우드 모델을 사용하기 전에, 모델 정보를 로컬로 가져와야 합니다:

    ollama pull gpt-oss:20b-cloud

  7. /models 명령을 실행하여 Ollama Cloud 모델을 선택하세요.

    /models

OpenAI

ChatGPT Plus 또는 Pro (opens in a new tab)에 가입하는 것을 권장합니다.

  1. 가입한 후, /connect 명령을 실행하고 OpenAI를 선택하세요.

    /connect

  2. 여기서 ChatGPT Plus/Pro 옵션을 선택하면 브라우저가 열리고 인증을 요청합니다.

    ┌ Select auth method
│
│ ChatGPT Plus/Pro
│ Manually enter API Key
└

  3. 이제 /models 명령을 사용할 때 모든 OpenAI 모델을 사용할 수 있습니다.

    /models
API 키 사용

이미 API 키가 있다면, Manually enter API Key를 선택하고 터미널에 붙여넣을 수 있습니다.

OpenCode Zen

OpenCode Zen은 OpenCode 팀이 제공하는 테스트되고 검증된 모델 목록입니다. 자세히 알아보기.

  1. **OpenCode Zen (opens in a new tab)**에 로그인하고 Create API Key를 클릭하세요.

  2. /connect 명령을 실행하고 OpenCode Zen을 검색하세요.

    /connect

  3. OpenCode API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Qwen 3 Coder 480B 같은 모델을 선택하세요.

    /models

OpenRouter

  1. OpenRouter 대시보드 (opens in a new tab)로 이동하여, Create API Key를 클릭하고, 키를 복사하세요.

  2. /connect 명령을 실행하고 OpenRouter를 검색하세요.

    /connect

  3. 프로바이더의 API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. 많은 OpenRouter 모델이 기본적으로 미리 로드되어 있습니다. /models 명령을 실행하여 원하는 것을 선택하세요.

    /models

    opencode 설정을 통해 추가 모델을 추가할 수도 있습니다.

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openrouter": {
      "models": {
        "somecoolnewmodel": {}
      }
    }
  }
}

  5. opencode 설정을 통해 사용자 정의할 수도 있습니다. 다음은 프로바이더를 지정하는 예시입니다

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openrouter": {
      "models": {
        "moonshotai/kimi-k2": {
          "options": {
            "provider": {
              "order": ["baseten"],
              "allow_fallbacks": false
            }
          }
        }
      }
    }
  }
}

LLM Gateway

  1. LLM Gateway 대시보드 (opens in a new tab)로 이동하여, Create API Key를 클릭하고, 키를 복사하세요.

  2. /connect 명령을 실행하고 LLM Gateway를 검색하세요.

    /connect

  3. 프로바이더의 API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. 많은 LLM Gateway 모델이 기본적으로 미리 로드되어 있습니다. /models 명령을 실행하여 원하는 것을 선택하세요.

    /models

    opencode 설정을 통해 추가 모델을 추가할 수도 있습니다.

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "llmgateway": {
      "models": {
        "somecoolnewmodel": {}
      }
    }
  }
}

  5. opencode 설정을 통해 사용자 정의할 수도 있습니다. 다음은 프로바이더를 지정하는 예시입니다

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "llmgateway": {
      "models": {
        "glm-4.7": {
          "name": "GLM 4.7"
        },
        "gpt-5.2": {
          "name": "GPT-5.2"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "claude-3-5-sonnet-20241022": {
          "name": "Claude 3.5 Sonnet"
        }
      }
    }
  }
}

SAP AI Core

SAP AI Core는 통합 플랫폼을 통해 OpenAI, Anthropic, Google, Amazon, Meta, Mistral 및 AI21의 40개 이상의 모델에 대한 액세스를 제공합니다.

  1. SAP BTP Cockpit (opens in a new tab)으로 이동하여, SAP AI Core 서비스 인스턴스로 이동한 다음, 서비스 키를 만드세요.

    팁: 서비스 키는 clientid, clientsecret, url, serviceurls.AI_API_URL을 포함하는 JSON 객체입니다. BTP Cockpit의 Services > Instances and Subscriptions 아래에서 AI Core 인스턴스를 찾을 수 있습니다.

  2. /connect 명령을 실행하고 SAP AI Core를 검색하세요.

    /connect

  3. 서비스 키 JSON을 입력하세요.

    ┌ Service key
│
│
└ enter

    또는 AICORE_SERVICE_KEY 환경 변수를 설정하세요:

    AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode

    또는 bash 프로필에 추가하세요:

    ~/.bash_profile
    export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}'

  4. 선택적으로 배포 ID와 리소스 그룹을 설정하세요:

    AICORE_DEPLOYMENT_ID=your-deployment-id AICORE_RESOURCE_GROUP=your-resource-group opencode

    참고: 이 설정들은 선택 사항이며 SAP AI Core 설정에 따라 구성해야 합니다.

  5. /models 명령을 실행하여 40개 이상의 사용 가능한 모델 중에서 선택하세요.

    /models

STACKIT

STACKIT AI Model Serving은 AI 모델을 위한 완전 관리형 주권 호스팅 환경을 제공하며, 유럽 인프라에서 최대한의 데이터 주권을 갖춘 Llama, Mistral, Qwen 같은 LLM에 중점을 둡니다.

  1. STACKIT Portal (opens in a new tab)로 이동하여, AI Model Serving으로 이동한 다음, 프로젝트의 auth 토큰을 만드세요.

    팁: auth 토큰을 만들기 전에 STACKIT 고객 계정, 사용자 계정 및 프로젝트가 필요합니다.

  2. /connect 명령을 실행하고 STACKIT을 검색하세요.

    /connect

  3. STACKIT AI Model Serving auth 토큰을 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Qwen3-VL 235B 또는 Llama 3.3 70B 같은 사용 가능한 모델 중에서 선택하세요.

    /models

OVHcloud AI Endpoints

  1. OVHcloud 패널 (opens in a new tab)로 이동하세요. Public Cloud 섹션, AI & Machine Learning > AI Endpoints로 이동한 다음, API Keys 탭에서 Create a new API key를 클릭하세요.

  2. /connect 명령을 실행하고 OVHcloud AI Endpoints를 검색하세요.

    /connect

  3. OVHcloud AI Endpoints API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 gpt-oss-120b 같은 모델을 선택하세요.

    /models

Scaleway

Opencode와 함께 Scaleway Generative APIs (opens in a new tab)를 사용하려면:

  1. Scaleway Console IAM 설정 (opens in a new tab)으로 이동하여 새 API 키를 생성하세요.

  2. /connect 명령을 실행하고 Scaleway를 검색하세요.

    /connect

  3. Scaleway API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 devstral-2-123b-instruct-2512 또는 gpt-oss-120b 같은 모델을 선택하세요.

    /models

Together AI

  1. Together AI 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, Add Key를 클릭하세요.

  2. /connect 명령을 실행하고 Together AI를 검색하세요.

    /connect

  3. Together AI API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Kimi K2 Instruct 같은 모델을 선택하세요.

    /models

Venice AI

  1. Venice AI 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 Venice AI를 검색하세요.

    /connect

  3. Venice AI API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Llama 3.3 70B 같은 모델을 선택하세요.

    /models

Vercel AI Gateway

Vercel AI Gateway를 사용하면 통합 엔드포인트를 통해 OpenAI, Anthropic, Google, xAI 등의 모델에 액세스할 수 있습니다. 모델은 마크업 없이 정가로 제공됩니다.

  1. Vercel 대시보드 (opens in a new tab)로 이동하여, AI Gateway 탭으로 이동한 다음, API keys를 클릭해 새 API 키를 만드세요.

  2. /connect 명령을 실행하고 Vercel AI Gateway를 검색하세요.

    /connect

  3. Vercel AI Gateway API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 모델을 선택하세요.

    /models

opencode 설정을 통해 모델을 사용자 정의할 수도 있습니다. 다음은 프로바이더 라우팅 순서를 지정하는 예시입니다.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "vercel": {
      "models": {
        "anthropic/claude-sonnet-4": {
          "options": {
            "order": ["anthropic", "vertex"]
          }
        }
      }
    }
  }
}

몇 가지 유용한 라우팅 옵션:

옵션설명
order시도할 프로바이더 순서
only특정 프로바이더로 제한
zeroDataRetention데이터 무보존 정책을 가진 프로바이더만 사용

xAI

세 가지 인증 방법: 브라우저 OAuth를 통한 SuperGrok 구독, 헤드리스 디바이스 코드 흐름을 통한 동일한 SuperGrok 구독(VPS / SSH / Docker용), 또는 xAI 콘솔의 종량제 API 키.

옵션 A — SuperGrok OAuth (브라우저 로그인)

  1. /connect 명령을 실행하고 xAI를 검색하세요.

    /connect

  2. **xAI Grok OAuth (SuperGrok Subscription)**를 선택하세요. OpenCode가 브라우저에서 xAI의 동의 화면을 열고 http://127.0.0.1:56121/callback에서 콜백을 기다립니다.

  3. /models 명령을 실행하여 Grok 모델을 선택하세요.

    /models

OpenCode는 OAuth 액세스 토큰을 자동으로 갱신합니다. Grok API 액세스를 포함하는 모든 Grok 또는 X Premium 요금제가 작동합니다. 별도의 XAI_API_KEY는 필요하지 않습니다.

옵션 B — SuperGrok 디바이스 코드 (헤드리스 / 원격 서버 / VPS)

브라우저가 루프백 리디렉션에 접근할 수 없는 곳에서 OpenCode가 실행될 때 이를 사용하세요: VPS, SSH를 통한 원격 개발 머신, Docker 내부, CI 등. OpenCode를 실행하는 호스트에서는 콜백 포트가 열리지 않습니다 — 대신 xAI가 CLI에 짧은 코드를 건네주고, 이를 다른 디바이스(노트북, 휴대폰 등)의 브라우저에 입력합니다.

  1. 원격 호스트에서 /connect 명령을 실행하고 xAI를 검색하세요.

    /connect

  2. **xAI Grok OAuth (Headless / Remote / VPS)**를 선택하세요. OpenCode가 확인 URL과 짧은 사용자 코드를 출력합니다.

    Open https://x.ai/device on any device and enter code: ABCD-1234

  3. 브라우저가 있는 디바이스(노트북 또는 휴대폰)에서 URL을 열고, 코드를 입력한 다음, 동의 화면을 승인하세요. OpenCode가 xAI의 토큰 엔드포인트를 폴링하고 승인하면 결과 OAuth 토큰을 저장합니다. 토큰 갱신은 옵션 A와 동일하게 작동합니다.

옵션 C — API 키

  1. xAI 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, API 키를 생성하세요.

  2. /connect 명령을 실행하고 xAI를 검색하세요.

    /connect

  3. Manually enter API Key를 선택하고 xAI API 키를 붙여넣으세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 Grok Beta 같은 모델을 선택하세요.

    /models

Z.AI

  1. Z.AI API 콘솔 (opens in a new tab)로 이동하여, 계정을 만들고, Create a new API key를 클릭하세요.

  2. /connect 명령을 실행하고 Z.AI를 검색하세요.

    /connect

    GLM Coding Plan에 구독되어 있다면, Z.AI Coding Plan을 선택하세요.

  3. Z.AI API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. /models 명령을 실행하여 GLM-4.7 같은 모델을 선택하세요.

    /models

ZenMux

  1. ZenMux 대시보드 (opens in a new tab)로 이동하여, Create API Key를 클릭하고, 키를 복사하세요.

  2. /connect 명령을 실행하고 ZenMux를 검색하세요.

    /connect

  3. 프로바이더의 API 키를 입력하세요.

    ┌ API key
│
│
└ enter

  4. 많은 ZenMux 모델이 기본적으로 미리 로드되어 있습니다. /models 명령을 실행하여 원하는 것을 선택하세요.

    /models

    opencode 설정을 통해 추가 모델을 추가할 수도 있습니다.

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zenmux": {
      "models": {
        "somecoolnewmodel": {}
      }
    }
  }
}

사용자 정의 프로바이더

/connect 명령에 나열되지 않은 OpenAI 호환 프로바이더를 추가하려면:

팁: opencode와 함께 모든 OpenAI 호환 프로바이더를 사용할 수 있습니다. 대부분의 최신 AI 프로바이더는 OpenAI 호환 API를 제공합니다.

  1. /connect 명령을 실행하고 아래로 스크롤하여 Other로 이동하세요.

    $ /connect
 
┌  Add credential
│
◆  Select provider
│  ...
│  ● Other
└

  2. 프로바이더의 고유 ID를 입력하세요.

    $ /connect
 
┌  Add credential
│
◇  Enter provider id
│  myprovider
└

    참고: 기억하기 쉬운 ID를 선택하세요. 설정 파일에서 이를 사용하게 됩니다.

  3. 프로바이더의 API 키를 입력하세요.

    $ /connect
 
┌  Add credential
│
▲  This only stores a credential for myprovider - you will need to configure it in opencode.json, check the docs for examples.
│
◇  Enter your API key
│  sk-...
└

  4. 프로젝트 디렉터리에 opencode.json 파일을 만들거나 업데이트하세요:

    opencode.json
    {
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My AI ProviderDisplay Name",
      "options": {
        "baseURL": "https://api.myprovider.com/v1"
      },
      "models": {
        "my-model-name": {
          "name": "My Model Display Name"
        }
      }
    }
  }
}

    다음은 구성 옵션입니다:

    • npm : 사용할 AI SDK 패키지로, OpenAI 호환 프로바이더(/v1/chat/completions용)에는 @ai-sdk/openai-compatible입니다. 프로바이더/모델이 /v1/responses를 사용하는 경우, @ai-sdk/openai를 사용하세요.
    • name : UI에 표시되는 이름.
    • models : 사용 가능한 모델.
    • options.baseURL : API 엔드포인트 URL.
    • options.apiKey : 인증을 사용하지 않는 경우, 선택적으로 API 키를 설정합니다.
    • options.headers : 선택적으로 사용자 정의 헤더를 설정합니다.

    아래 예시에서 고급 옵션에 대해 더 알아보세요.

  5. /models 명령을 실행하면 사용자 정의 프로바이더와 모델이 선택 목록에 나타납니다.

예시

다음은 apiKey, headers 및 모델 limit 옵션을 설정하는 예시입니다.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My AI ProviderDisplay Name",
      "options": {
        "baseURL": "https://api.myprovider.com/v1",
        "apiKey": "{env:ANTHROPIC_API_KEY}",
        "headers": {
          "Authorization": "Bearer custom-token"
        }
      },
      "models": {
        "my-model-name": {
          "name": "My Model Display Name",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        }
      }
    }
  }
}

구성 세부 정보:

  • apiKey : env 변수 구문을 사용하여 설정합니다. 자세히 알아보기 .
  • headers : 각 요청과 함께 전송되는 사용자 정의 헤더.
  • limit.context : 모델이 받아들이는 최대 입력 토큰.
  • limit.output : 모델이 생성할 수 있는 최대 토큰.

limit 필드를 사용하면 OpenCode가 남은 컨텍스트가 얼마나 되는지 이해할 수 있습니다. 표준 프로바이더는 이를 models.dev에서 자동으로 가져옵니다.

문제 해결

프로바이더 구성에 문제가 있는 경우, 다음을 확인하세요:

  1. auth 설정 확인: opencode auth list를 실행하여 프로바이더의 자격 증명이 설정에 추가되었는지 확인하세요. 이는 인증에 환경 변수를 사용하는 Amazon Bedrock 같은 프로바이더에는 적용되지 않습니다.

  2. 사용자 정의 프로바이더의 경우, opencode 설정을 확인하고:

    • /connect 명령에서 사용된 프로바이더 ID가 opencode 설정의 ID와 일치하는지 확인하세요.
    • 프로바이더에 올바른 npm 패키지가 사용되었는지 확인하세요. 예를 들어 Cerebras에는 @ai-sdk/cerebras를 사용하세요. 그리고 다른 모든 OpenAI 호환 프로바이더에는 @ai-sdk/openai-compatible(/v1/chat/completions용)을 사용하세요; 모델이 /v1/responses를 사용하면 @ai-sdk/openai를 사용하세요. 하나의 프로바이더 아래 혼합 설정의 경우, provider.npm을 통해 모델별로 재정의할 수 있습니다.
    • options.baseURL 필드에 올바른 API 엔드포인트가 사용되었는지 확인하세요.
설정네트워크