opencode와 Claude Code — provider 카탈로그와 소켓

둘 다 터미널 에이전트입니다. 둘 다 누가 요금을 청구할지 선택할 수 있게 합니다. 차이는 각 도구에서 ‘공급자’가 무엇을 의미하느냐입니다. opencode에서 공급자는 카탈로그 항목이고 카탈로그는 전체 레지스트리를 포괄하므로, 한 번 설치하면 여러 연구소의 모델을 실행할 수 있습니다. Claude Code에서 공급자는 Anthropic Messages API 프로토콜을 지원해야 하는 기본 URL입니다. 이 검색어의 비교 글들은 두 도구를 사용감과 출력으로 평가하지만, 1년 후에도 무엇을 할 수 있는지를 결정하는 사실은 이것입니다.

나란히 비교

실제로 각 도구를 설정하는 모습

# Claude Code — the endpoint is two environment variables, and whatever
# answers there must speak the Anthropic Messages API.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves. Claude Code's default and its opus alias are the
# newest Opus — pinned here to Opus 5.5, which needs Claude Code v2.1.280 or
# later (run `claude update`). The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve: unpinned, /model sonnet, opusplan's execution phase
# and sonnet subagents 404.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# opencode — the provider is a catalog entry in opencode.json, and the
# protocol travels with it. OpenAI-compatible in this case:
{
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://api.kunavo.com/v1" },
      "models": { "claude-sonnet-5": {}, "claude-haiku-4-5": {} }
    }
  }
}

둘 다 몇 줄이면 설정할 수 있으며, 그 유사성이 핵심입니다. 이 도구들의 비용 논의는 본질적인 차이보다 주로 기본값에 관한 것입니다. 둘을 같은 엔드포인트에 연결하면 가격 차이는 사라지고, 남는 것은 각 단계에서 얼마나 많은 컨텍스트를 다시 전송하느냐입니다. 이는 도구 이름보다 저장소에 훨씬 더 좌우됩니다.

선호의 문제가 아닌 차이

메인 루프에는 Claude 모델을 사용하고 백그라운드 작업에는 더 저렴한 모델을 사용하고 싶다면 opencode는 한 번의 설치로 가능하지만 Claude Code는 그렇지 않습니다. Claude Code의 저렴한 계층도 Claude 모델(ANTHROPIC_DEFAULT_HAIKU_MODEL)이어야 하는데, 소켓이 Anthropic 형태이기 때문입니다. 어느 동작도 잘못된 것은 아니며 설계가 다를 뿐입니다. 하지만 이 차이는 설정으로 없앨 수 없는 두 도구 간 유일한 차이이고, 이 검색어의 어떤 비교 글도 이를 언급하지 않습니다.

두 구조의 비용 계산은 Claude Code costs에, 등급 비교는 Opus vs Sonnet vs Haiku에 나와 있습니다.

이 페이지에서 다루지 않는 것

어느 쪽이 더 나은 코드를 작성하는지는 말해 주지 않습니다. 동일한 작업으로 두 도구를 통제 비교한 적이 없으며, 이 검색어의 상위 글들도 측정값이 아니라 자신이 사용한 인상을 순위로 매긴 것입니다. 게시할 만한 정당한 내용이지만 측정은 아닙니다. 믿을 만한 실험은 직접 하는 것입니다. 두 도구를 같은 키로 연결하고 같은 실제 작업을 실행한 뒤 diff와 비용을 확인하세요.

각 도구의 설정: 사용자 지정 provider를 사용하는 opencode 및 Claude Code용 API 키. 아직 전체를 살펴보는 중이라면 Claude Code alternatives가 먼저 도구 선택과 결제 선택을 분리해 설명합니다.

자주 묻는 질문