Coding Agent 설정

OpenCode 사용자 지정 모델 및 API 설정

/connect와 opencode.json으로 OpenCode를 BetterToken Chat Completions에 연결하세요. API Key, Base URL, Model ID를 설정합니다.

OpenCode는 @ai-sdk/openai-compatible을 사용해 BetterToken에 연결합니다. OpenCode 제공자 이름은 BetterToken 또는 OpenAI Compatible로 지정하세요. 일반적인 API Key, Base URL, opencode.json 설정에는 이 페이지를 사용하세요. 특정 모델을 선택하고 확인하려면 GLM 가이드 또는 Kimi K3 가이드를 확인하세요. 모델 광장에서 정확한 Model ID를 복사하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

준비 사항

아래 명령어로 OpenCode 1 설치
BetterToken API Key 생성
모델 광장 또는 Key 설정 대화 상자에서 Model ID 복사

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

설치하기

아래 명령어는 OpenCode 1을 설치합니다. OpenCode 2는 해당 설치 가이드를 사용하세요. OpenCode 2는 같은 위치에서 기존 설정을 읽고 지원되는 V1 제공자 설정을 변환합니다. 설정 문법을 변경하기 전에 마이그레이션 가이드를 확인하세요.

curl

curl -fsSL https://opencode.ai/install | bash

npm

npm install -g opencode-ai

명령줄 설정

BetterToken 자동 설정 스크립트는 OpenCode의 BetterToken 제공자를 생성하거나 업데이트합니다. Node.js가 필요합니다. API Key 또는 Model ID를 인수로 전달하지 않으면 직접 입력하라는 메시지가 표시됩니다.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-opencode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-opencode-provider.ps1" -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

스크립트가 완료되면 bettertoken/YOUR_MODEL_ID를 선택하세요. OpenCode가 이미 실행 중이라면 테스트 전에 다시 시작하세요.

수동 설정

방법 1: /connect로 인증 정보 저장

OpenCode를 시작하고 다음을 실행하세요.

/connect

Other를 선택하고 제공자 ID로 bettertoken을 입력한 뒤 YOUR_API_KEY를 입력하세요. OpenCode가 인증 정보를 로컬에 저장합니다.

방법 2: JSON 설정

전역 파일은 ~/.config/opencode/opencode.json입니다. 프로젝트 루트에서는 opencode.json을 사용할 수 있습니다.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

/connect를 사용하지 않으면 "apiKey": "YOUR_API_KEY"를 options 아래에 추가하세요. 실제 Key가 포함된 설정은 절대 커밋하지 마세요.

이 예제는 Chat Completions에 @ai-sdk/openai-compatible을 사용합니다. SDK 패키지는 엔드포인트 프로토콜과 일치해야 합니다. 다른 프로토콜을 사용하기 전에 공식 제공자 안내를 확인하세요. GPT 모델을 사용한 macOS 테스트에서 OpenCode 1.19.4와 2.1.4는 각 SDK로 파일 읽기 도구 호출을 완료했습니다. @ai-sdk/openai-compatible은 /v1/chat/completions를, @ai-sdk/openai는 /v1/responses를 사용했습니다. read를 허용하고 edit 및 bash를 거부한 네 가지 파일 읽기 사례가 모두 통과했습니다.

연결 확인

프로젝트에서 opencode를 실행하고 bettertoken/YOUR_MODEL_ID를 선택한 뒤 짧은 메시지를 보내세요. 정상 응답이 오면 설정이 완료된 것입니다. JSON을 변경한 뒤에는 OpenCode를 다시 시작하세요.

OpenCode 1에서 비대화형 텍스트를 확인하려면 다음을 실행하세요.

opencode run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

OpenCode 2에서 비대화형으로 실행하려면 --standalone이 필요합니다.

opencode run --standalone --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

모델 전환

새 YOUR_MODEL_ID를 provider.bettertoken.models 아래에 추가하고 최상위 model을 업데이트한 뒤 저장하고 다시 시작하세요.

흔한 오류

오류	해결 방법
`401`	`/connect`를 다시 실행하거나 `apiKey`를 확인하세요.
`404`	`https://bettertoken.ai/v1`만 `baseURL`로 사용하고 `/chat/completions`를 추가하지 마세요.
모델을 찾을 수 없음	최상위 `model`이 `models` 아래의 ID와 정확히 일치하도록 설정하세요.
설정이 적용되지 않음	프로젝트의 `opencode.json`이 전역 파일을 덮어쓰는지 확인한 뒤 OpenCode를 다시 시작하세요.