OpenCode를 CheapTokens에 연결하는 방법 (opencode.json)

OpenCode를 CheapTokens에 연결하려면 사용자 정의 OpenAI 호환 프로바이더를 추가하세요. /connect로 API 키를 저장하고(프로바이더 ID cheaptokens), 그런 다음 opencode.json에서 기본 URL https://api.cheaptokens.dev/v1과 함께 프로바이더를 설명합니다. 그러면 CheapTokens 모델이 /models에 나타납니다.

이 가이드는 OpenCode 프로바이더 문서를 따릅니다(페이지 업데이트: 2026년 10월 20일, 확인: 2026년 10월 22일). 동일한 방법이 이 시리즈의 다른 도구에도 적용됩니다: Cline, Aider, Kilo Code.

필요한 것#

• OpenCode 설치(사용 중인 플랫폼에 대한 문서 참조).
• CheapTokens API 키. 계정에서 생성하고 잔액을 충전하세요. 하나의 잔액으로 모든 모델을 사용할 수 있습니다. 기본 사항은 CheapTokens 문서에 있습니다.
• API 정보:
  • 기본 URL: https://api.cheaptokens.dev/v1
  • 호환성: OpenAI Chat Completions 및 Anthropic Messages
  • 아래에서 사용하는 모델 ID: deepseek-ai/DeepSeek-V4-Flash-0731 (380K 컨텍스트, 최대 32,768 출력 토큰). 모델 ID는 CheapTokens 문서에 나열되어 있습니다. 프로바이더마다 이름이 다르므로 거기서 ID를 복사하세요.

1단계. /connect로 키 저장#

1. 프로젝트에서 OpenCode를 시작하고 /connect를 실행합니다.
2. Other로 스크롤합니다.
3. 고유한 프로바이더 ID를 입력합니다: cheaptokens.
4. CheapTokens API 키를 붙여넣습니다.

이 단계는 자격 증명만 저장합니다. OpenCode는 아직 프로바이더의 주소나 모델을 알지 못합니다. 그것이 opencode.json의 역할입니다.

2단계. opencode.json에서 프로바이더 설명#

opencode.json를 생성하거나 편집하고 프로바이더를 추가합니다. provider의 프로바이더 ID는 /connect에서 입력한 것과 일치해야 합니다.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

각 부분의 역할:

• npm — @ai-sdk/openai-compatible은 /v1/chat/completions을 사용하는 엔드포인트용 패키지이며, CheapTokens가 노출하는 것이 바로 이것입니다. (OpenCode는 /v1/responses을 기반으로 구축된 엔드포인트에 @ai-sdk/openai를 사용합니다.)
• name — OpenCode 인터페이스에 표시되는 레이블입니다.
• options.baseURL — CheapTokens API 주소입니다.
• models — 모델 ID를 키로 사용하며, 내부의 name은 표시 이름입니다.
• limit.context / limit.output — 선택 사항이며, OpenCode에 모델의 컨텍스트 창과 최대 답변 길이를 알려줍니다.

대신 환경 변수에 키 보관(선택 사항)#

OpenCode의 자격 증명 저장소에 키를 보관하고 싶지 않다면, 문서에서 권장하는 {env:VARIABLE} 구문으로 options에 apiKey을 추가하세요:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

그런 다음 셸에서 CHEAPTOKENS_API_KEY를 내보내세요. 실제 키를 저장소에 커밋하지 마세요. 키가 처음이라면 API 키란 무엇이며 안전하게 저장하는 방법을 읽어보세요.

3단계. 작동하는지 확인#

/models를 실행하고 CheapTokens 프로바이더 아래에서 DeepSeek-V4-Flash를 선택합니다. 그런 다음 짧은 프롬프트를 보내세요. 예: "이 저장소가 하는 일을 세 문장으로 요약해줘." 정상적인 답변이 오면 기본 URL, 키, 모델 ID가 모두 올바른 것입니다.

어떤 CheapTokens 모델을 선택할까#

models에 원하는 만큼 항목을 추가하세요. 각 항목은 위와 같은 블록이며 고유한 ID를 가집니다.

루프에서 많은 요청을 보내는 OpenCode 세션에는 DeepSeek-V4-Flash가 좋은 기본값입니다. 출력이 OpenRouter 기준가보다 저렴하고, 답변이 32,768 토큰에 도달할 수 있으며, 피크 시간 요금이 없습니다. MiniMax-M2.7도 입력과 출력 모두 OpenRouter 기준가보다 저렴합니다. GLM-5.3-Flash의 출력도 OpenRouter 기준가보다 저렴합니다. 현재 가격(실시간 확인, 오래된 숫자 없음):

작업 세션을 추정하려면, 예를 들어 각각 100,000 입력 및 5,000 출력 토큰인 20개 요청:

자세한 내용은 전체 가격과 DeepSeek 페이지를 참조하세요.

작동하지 않을 경우#

• /models에서 프로바이더나 모델이 누락됨. opencode.json이 유효한 JSON인지(후행 쉼표 없음) 확인하고, provider 아래의 키가 /connect에서 입력한 ID와 정확히 일치하는지 확인하세요. 둘 다 올바르면 OpenCode를 다시 시작하세요.
• 401 / 인증 오류. /connect를 다시 실행하고 키를 다시 붙여넣거나, OpenCode가 시작되는 셸의 CHEAPTOKENS_API_KEY 변수를 확인하세요.
• 404 또는 "model not found". models의 모델 ID는 벤더 접두사(deepseek-ai/…)를 포함하여 CheapTokens ID와 문자 단위로 일치해야 합니다.
• 연결 오류. 기본 URL은 /v1로 끝나야 하며 추가 경로가 없어야 합니다. 일반적인 연결 오류를 참조하세요.
• "Not enough tokens". 잔액을 충전하세요. 오류의 의미를 참조하세요.

다음 단계#

이제 OpenCode가 CheapTokens에서 실행되며 모든 모델에 하나의 잔액을 사용합니다. CheapTokens 문서에서 키를 받고 첫 호출을 해보세요.