VT Code와 OpenCode: 워크플로, 모델, 총비용

VT Code와 OpenCode는 모두 클라이언트 비용을 전혀 받지 않는 무료 터미널 코딩 에이전트이며, 둘 다 사용자가 직접 OpenAI 호환 엔드포인트를 지정할 수 있으므로 이는 가격 비교가 아닙니다. 실제 차이는 각 도구에서 해당 엔드포인트를 선언하는 위치, 권한 기본값의 방향, 그리고 같은 환경에서 월 $10 구독을 원하는지 여부입니다. VT Code는 한 명의 유지 관리자가 이끄는 독립 프로젝트의 단일 Rust 바이너리입니다. OpenCode는 Anomaly라는 회사의 TypeScript 에이전트로, 데스크톱 앱, 편집기 확장 기능, 자체 퍼스트파티 지갑 두 개를 제공합니다.

두 가지 이름 혼동부터 먼저 해소해야 합니다. 둘 중 하나라도 잘못 이해하면 이후의 모든 내용이 무효가 되기 때문입니다. "VT Code"는 Visual Studio Code가 아니며, VT Code는 혼동스럽게도 별도의 버전 계열로 자체 VS Code 보조 확장 기능을 제공합니다. 또한 OpenCode라는 이름은 서로 다른 세 가지를 가리킵니다 — 이 비교에 포함되는 것은 그중 하나뿐입니다.

실제로 비교하는 대상

저장소 메타데이터, 릴리스 및 dist-tag는 2026년 9월 21일에 GitHub API, npm 및 crates.io에서 확인했습니다. 네 번째 혼동이 있습니다. "OpenCode Go"는 Anomaly의 월 $10 구독 요금제 이름이기도 합니다. 이는 Go 언어나 보관된 Go CLI와 아무 관련이 없으며, VT Code는 기본 제공 프로바이더 키 중 하나를 opencode-go로 명명해 혼동을 더합니다. 또한 VT Code의 버전이 얼마나 빠르게 변하는지도 유의하세요. 0.164.0, 0.164.2, 0.165.0이 9월 20~21일 약 27시간 안에 모두 출시되었으므로, 이 페이지를 포함해 어느 페이지에 인쇄된 버전도 그대로 믿지 말고 태그를 확인하세요.

누가 무엇을 선택해야 하나요

마이그레이션 비용에 관해. 저렴한 부분은 AGENTS.md입니다. 두 도구 모두 프로젝트 루트에서 이를 읽으므로, 규칙을 설명하는 파일은 어느 방향으로 이동해도 수정 없이 유지됩니다. 비싼 부분은 나머지 전부입니다. 두 설정 형식은 서로 완전히 다릅니다 — 테이블 배열을 사용하는 TOML과 프로바이더별 npm 패키지를 지정하는 JSON — 변환기가 없으므로 프로젝트 로컬 설정은 직접 다시 작성해야 합니다. MCP 정의, 스킬, 플러그인, 사용자 지정 에이전트 또는 세션 기록이 이전되는지는 이 페이지에서 확인하지 않았으므로, 해당 재작성 외의 마이그레이션 시간은 추정하지 않습니다.

결정을 좌우할 만한 유일한 비대칭: 엔드포인트가 위치할 수 있는 곳

이는 어떤 일반적인 템플릿에도 언급되지 않는 차이이며, 일반적인 모노레포 방식에 대한 직관을 뒤집습니다. OpenCode는 사용자 지정 프로바이더를 일반적인 프로젝트 데이터로 취급하므로 커밋된 opencode.json이 작동하고, 팀이 검토된 단일 파일로 모두를 하나의 게이트웨이에 맞추는 방식입니다. VT Code는 의도적으로 이를 거부합니다.

VT Code의 설정 필드 참조는 필드 자체에 이를 명시합니다. "저장소가 제어하는 워크스페이스/프로젝트 계층의 비어 있지 않은 값은 거부됩니다. 프로바이더 엔드포인트는 신뢰할 수 있는 시스템/사용자 설정 또는 명시적으로 선택한 설정에 정의하세요." 같은 거부 동작은 custom_providers[].base_url, custom_providers[].auth.command, provider_overrides.*.base_url 및 .api_key_env에도 반복됩니다. 보안 모델은 그 이유를 별도 계층으로 설명합니다. 로더는 병합된 각 필드의 최종 출처를 기록하고, 워크스페이스 루트 파일, 워크스페이스 .vtcode/ 파일 및 프로젝트 프로필을 저장소가 제어하는 것으로 간주하며, 프로바이더 검증 전에 안전하게 실패합니다. 문서에 따르면 이는 저장소가 사용자 지정 프로바이더의 실행 가능한 auth.command를 도입하거나 재정의된 기본 URL을 통해 요청을 리디렉션하는 것을 방지합니다.

따라서 실제 결과는 다음과 같습니다. OpenCode에서는 병합된 풀 리퀘스트 하나로 전체 팀을 게이트웨이에 연결할 수 있습니다. VT Code에서는 같은 변경을 사용자 또는 시스템 설정에 컴퓨터별로 설치하거나 실행 시 --config 경로를 전달해야 합니다. 이는 진정한 트레이드오프입니다 — 하나는 배포 편의성이고 다른 하나는 공급망 통제입니다. 어느 쪽을 선호하든, 그 선호는 어떤 기능 목록보다도 여기서 클라이언트를 선택할 더 강력한 이유가 됩니다. 두 사실 모두 2026년 9월 21일 main에서 확인했습니다.

권한, 자율성 및 각 도구가 제공하는 사용 환경

출처: VT Code의 설정 필드 참조, 보안 모델 및 프로바이더 가이드; OpenCode의 권한, 프로바이더, 서버 및 ACP 문서. 모두 2026년 9월 21일에 확인했으며, 모두 기본값을 설명합니다 — 어느 클라이언트든 반대 방향으로 재구성할 수 있습니다. 둘 다 ACP를 사용하고 MCP를 지원하므로 편집기 연동 범위는 차별화 요소라기보다 거의 대등합니다.

돈이 들어가는 곳은 클라이언트가 아니라 지갑입니다

OpenCode는 자체적으로 두 가지를 판매합니다. VT Code는 아무것도 판매하지 않으며, 이것 자체가 선택의 기준입니다. 전송하는 모든 토큰은 사용자가 구성한 대상이 청구하고, 의존할 퍼스트파티 요금제가 없습니다.

가격과 할당량은 2026년 9월 21일 OpenCode 자체 문서에서 확인했습니다. 비교하기 전에 알아둘 점이 두 가지 있습니다. Go는 모델별 데이터 약관을 균일하게 제공하지 않습니다. 대부분의 행에는 모델 학습에 사용되지 않음과 0일 보존이 표시되지만, 일부는 30일 보존을 명시하고 두 기여자 모델은 학습에 사용되며 0일 보존이 아닌 것으로 표시됩니다. 따라서 실제 사용할 모델의 행을 확인하세요. 또한 Zen은 날짜가 지정된 지원 중단을 게시하므로, 하나의 모델 ID를 기준으로 한 비교는 페이지 자체보다 빠르게 낡을 수 있습니다. OpenCode Enterprise는 공개 가격이 없는 문의 양식이며, 이 페이지에서는 가격을 인용하지 않습니다.

자체 엔드포인트에서 세션 하나에 드는 비용

아래 수치는 측정된 작업 비용이나 청구 상한이 아닌, 토큰 산술 예시입니다. 한 에이전트 세션이 200,000개의 캐시되지 않은 입력 토큰을 보내고 15,000개의 출력 토큰을 받는다고 가정합니다. 이는 비교를 위한 가정이지 저장소를 측정한 값이 아닙니다. 요금은 토큰 100만 개당 Kunavo 카탈로그의 현재 가격이며, 마지막 열은 단순히 나눈 값이므로 앞의 모든 가정을 그대로 상속합니다.

마지막 열을 OpenCode Go의 월 $10와 비교하되, 이를 판정이라고 부르고 싶은 충동은 억제하세요. 둘은 같은 단위가 아닙니다. Go의 한도는 자체 모델 목록에서 사용한 금액으로 표시되며 실제 지출 금액이 아니고, 두 목록은 일부만 겹칩니다. GPT 5.6 Luna는 Go의 공개 목록에 있지만 위 표의 Claude 및 Gemini 행은 없습니다. 구독은 요금이 아니라 예측 가능성도 제공합니다. 표가 확정하는 것은 질문의 형태입니다. 저렴한 모델로 일주일에 몇 번 긴 세션을 사용하는 작업이라면 종량제 토큰이 먼저 유리하고, Go가 실제로 제공하는 모델을 하루 종일 많이 사용한다면 고정 요금제가 명백히 더 나쁘지는 않습니다. 선택하기 전에 직접 세션을 측정하세요. 두 번째 시도가 필요한 모델은 요금상의 이점을 즉시 없애기 때문입니다.

Kunavo 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림이 요금을 보고하면 청구 금액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 금액 중 큰 값입니다. 캐시 요금과 외부 도구는 이 예시에 포함되지 않습니다. 최소 충전액은 선불 크레딧 $10입니다. 이는 자금 충전 최소액이지 작업 요금이나 구독료가 아닙니다. billing details를 참조하세요.

어느 쪽이든 자체 엔드포인트로 연결하기

VT Code 측은 [[custom_providers]] 블록을 사용하며, 앞 섹션의 배치 규칙이 사람들이 가장 자주 잘못 이해하는 부분입니다.

# This block is rejected if it arrives from a repository-controlled
# layer. Put it in your user config, in the Unix system layer
# (/etc/vtcode/vtcode.toml), or pass it with --config / VTCODE_CONFIG_PATH.
[[custom_providers]]
name = "kunavo"
display_name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
api_key_env = "KUNAVO_API_KEY"
api_format = "openai-chat"
model = "claude-sonnet-5"
models = ["claude-sonnet-5", "claude-haiku-4-5"]
context_window = 1000000   # omit this and VT Code assumes 128000

이 블록에 관한 네 가지 참고 사항은 모두 프로바이더 가이드와 필드 참조에서 가져왔습니다. 키는 api_key_env에 지정된 환경 변수에서 읽으며, 설정 문서에는 API 키를 vtcode.toml에 절대 넣지 말라는 명시적인 주의가 있습니다. api_format은 auto, openai-chat, openai-responses 또는 anthropic-messages를 허용합니다. 명시적인 값은 조용히 기본값으로 대체되지 않고 그대로 사용됩니다. 또한 두 기본 URL 규칙이 다르므로 Anthropic 경로는 별도로 살펴볼 가치가 있으며, 기본 URL 참조에서 이를 다룹니다. context_window 설정도 중요합니다. 이를 생략하면 프로바이더가 128,000토큰으로 간주되어 훨씬 더 큰 컨텍스트에서 압축 및 사전 확인이 조용히 제한됩니다. VT Code는 사용자 지정 엔드포인트에도 이름 기반 OpenAI 샘플링 제한을 적용합니다. 예를 들어 모델 ID가 gpt-6-astra과 일치하면 temperature 또는 top_p를 절대 받지 않습니다. 가이드의 권고는 "이러한 이름에 고정된 값을 사용해야 한다면 게이트웨이에서 중립적인 모델 ID를 우선 사용하라"는 것입니다.

OpenCode의 대응 방식은 데이터 파일이며, npm 필드가 와이어 형식을 선택합니다. @ai-sdk/openai-compatible은 /v1/chat/completions를 제공하는 엔드포인트용이고, @ai-sdk/openai은 /v1/responses용입니다.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": { "context": 1000000, "output": 128000 }
        }
      }
    }
  }
}

OpenCode는 사용자 지정 프로바이더를 선언하는 대신 baseURL의 기본 제공 프로바이더를 재정의할 수도 있습니다. 문서에 따르면 알려진 프로바이더의 모델 메타데이터는 Models.dev에서 가져오므로, 직접 선언한 프로바이더는 자체 limit를 제공해야 합니다. 또한 /connect 명령으로 추가한 키는 ~/.local/share/opencode/auth.json에 저장됩니다. Kunavo는 이 클라이언트를 위한 설정 페이지를 제공합니다: OpenCode 통합 가이드. 여기에는 VT Code 통합 페이지가 없으며, 위 TOML 블록은 VT Code의 문서화된 필드 정의를 바탕으로 구성한 설정 참조입니다. 어느 클라이언트도 Kunavo를 대상으로 런타임 테스트를 거치지 않았으며, 어느 쪽에도 호환성을 주장하지 않습니다. 작동하는 경로를 유지하고, 범위가 제한된 작업 하나를 실행한 다음, 일상적인 주 사용 도구를 전환하기 전에 계정에 기록된 청구액을 확인하세요. 키에 자금을 충전할 준비가 되면 Kunavo 계정을 생성하세요.

실제 시간을 낭비하게 만드는 설치 관련 주의사항이 하나 있습니다. vtcode이라는 공개 npm 패키지는 현재의 VT Code가 아닙니다. 이 패키지의 dist-tag latest는 0.52.8이며 2025년 12월 24일에 게시되었지만, 2026년 9월 21일 기준 crates.io의 버전은 0.165.0이었습니다. VT Code의 설치 문서에는 npm install -g @vinhnx/vtcode --registry=https://npm.pkg.github.com라는 다른 npm 경로와 함께 cargo install vtcode 및 brew trust vinhnx/tap 후에 brew install vinhnx/tap/vtcode을 실행해야 하는 Homebrew tap이 안내되어 있습니다. 같은 문서에서는 Windows 아티팩트가 최선의 노력으로만 제공되며 모든 릴리스에 포함되지 않을 수 있다고 경고합니다. 한편 OpenCode의 자체 설치 페이지는 Windows에서 WSL을 권장합니다. 따라서 각자의 공식 문서만 놓고 보면 어느 쪽도 Windows를 일급 지원 대상으로 보기는 어렵습니다.

더 넓게 비교하고 있나요? Crush와 OpenCode 비교에서는 같은 OpenCode를 Charm의 에이전트와 비교하고, OpenCode 가격에서는 Zen과 Go를 더 자세히 다루며, OpenAI 호환 API 참조에서는 두 클라이언트가 의존하는 엔드포인트 규칙을 설명합니다.

자주 묻는 질문

2026년 9월 21일 확인 내용: 세 저장소 모두에 대한 GitHub API와 VT Code 릴리스 목록, opencode-ai, @opencode/cli, vtcode의 npm dist-tag, vtcode의 crates.io 기록, main의 VT Code README·보안 모델·프로바이더 가이드·설정 필드 참조·설치 문서·VS Code 확장 매니페스트, 그리고 OpenCode의 권한·프로바이더·서버·Zen·Go·다운로드 페이지입니다. Kunavo 토큰 요금은 실시간 카탈로그에서 가져왔습니다. 이 페이지를 위해 어느 클라이언트도 설치하거나 실행하거나 Kunavo 엔드포인트에 연결하지 않았고, 벤치마크나 성능 비교도 수행하지 않았으며 그러한 주장을 하지 않습니다. 여기의 모든 달러 수치는 측정된 작업 비용이 아닌 토큰 산술 예시입니다.