OpenCode V2 리뷰: 설치·요금·LSP와 V1 차이

기존 OpenCode 설정을 V2로 옮길 때는 설치 방식과 LSP 지원이 달라집니다. 공식 문서로 모델 로그인 조건, Console·Go 비용, 실행 권한을 검토합니다.

OpenCode는 여러 모델 제공자를 연결해 코드 작성과 수정을 맡기는 오픈소스 AI 코딩 에이전트입니다. OpenCode V2 공식 소개는 터미널·데스크톱·웹 인터페이스를 안내합니다. OpenCode 1(V1)과 OpenCode 2(V2)는 설치 경로와 지원 기능이 다릅니다.

평가 범위는 2026년 10월 15일 확인한 공식 문서의 기능과 도입 조건입니다. 제품 설치·로그인·결제·성능 시험은 수행하지 않았습니다.

V1·V2는 설치 경로와 LSP 지원이 다릅니다

이 글의 대상은 MIT 라이선스로 공개된 anomalyco/opencode 저장소의 OpenCode입니다. 이름이 같은 opencode-ai/opencode의 보관 안내는 해당 프로젝트의 아카이브 상태와 원저자·Charm 팀의 Crush 이행을 설명합니다. Bubble Tea 구현과 LOCAL_ENDPOINT 설명은 이 보관된 프로젝트의 자료입니다.

V1 설치 문서와 V2 설치 문서의 명령은 다음처럼 구분됩니다. 표는 10월 15일의 문서 안내이며 실제 설치 결과는 아닙니다.

설치 항목	OpenCode V1	OpenCode V2
npm 명령	npm install -g opencode-ai	npm install -g @opencode/cli
설치 스크립트	V1 공식 설치 문서의 스크립트	V2 공식 설치 문서의 스크립트
Homebrew 명령	brew install anomalyco/tap/opencode	brew install anomalyco/tap/opencode-v2
Windows 네이티브	Chocolatey·Scoop·npm 안내	패키지 관리자 미지원, 독립 CLI 바이너리·데스크톱 앱 다운로드 안내

두 버전은 모두 opencode 명령과 같은 설정 위치를 사용합니다. OpenCode V1 이행 문서는 패키지 관리자로 설치한 V1을 제거한 뒤 V2를 설치하도록 안내하며, V2의 curl 설치기는 V1 바이너리를 대체합니다. 기존 설정 사본을 보관하고 모델·인증·에이전트·권한·MCP를 확인하는 과정이 필요합니다. V1 플러그인과 서버 API 연동에는 별도 이행 작업이 있습니다.

Windows에서 WSL을 권장하는 설명은 V1 Windows 안내에 있습니다. V2의 Windows 설치에는 위 표의 전용 안내가 적용됩니다. 저장소의 일반 설치 표와 버전별 문서가 다를 때는 사용할 버전의 설치 문서를 기준으로 경로를 고릅니다.

LSP는 언어 서버의 코드 진단 등을 개발 도구에 전달하는 프로토콜입니다. V1 LSP 문서에서는 기본값이 비활성이며, opencode.json의 lsp: true 또는 서버별 설정으로 켭니다. 언어별 실행 조건도 필요합니다. TypeScript는 프로젝트의 typescript 의존성, gopls는 go 명령이 있어야 하며, 사용자 지정 서버의 command는 문자열 배열로 작성합니다.

V2는 lsp 설정을 읽어 보존해도 언어 서버를 실행하거나 LSP 도구·진단을 제공하지 않습니다. 앞의 이행 문서는 프로젝트의 린트·타입 검사·컴파일러 명령을 대안으로 안내합니다.

Claude Code의 코드 인텔리전스 플러그인은 언어 서버를 설치한 터미널 세션에서 진단과 정의·참조 탐색을 제공합니다. 클라우드 세션에서는 플러그인 언어 서버를 시작하지 않습니다.

모델 연결은 로그인 방식과 프로젝트 권한에 따라 달라집니다

V2에서 모델을 연결하는 순서는 /connect로 제공자를 연결한 뒤 /models에서 사용할 모델을 고르는 것입니다. OpenCode 제공자 문서에는 API 키 입력, 계정 로그인, 로컬 서버 탐색처럼 연결 방식이 나뉘어 있습니다. 연결에 필요한 계정 권한과 모델 사용료는 선택한 제공자에 따라 달라집니다.

GitHub Copilot은 기기 인증 방식의 OAuth 로그인을 사용합니다. /connect에서 GitHub Copilot을 선택하고 GitHub.com 또는 GitHub Enterprise 인증을 마친 뒤 모델 목록을 엽니다. 연결 계정에는 Copilot Chat 접근 권한이 필요하며, 공식 안내는 권한이 없을 때 Copilot Free 가입 또는 조직의 좌석 할당을 확인하도록 설명합니다.

V2 모델 문서에 따르면 /models에는 해당 프로젝트에서 활성화되어 있고 이용 가능한 제공자의 모델만 표시됩니다. 모델 선택값은 provider/model이며 실행·세션·에이전트·명령에서 변형 옵션을 고를 때는 #variant를 붙일 수 있습니다. high나 max 같은 옵션 이름은 모델마다 다르므로 목록에 있는 값을 사용합니다. 다른 프로젝트에서 쓴 연결과 자격 증명이 자동으로 이어지는 것도 아닙니다.

로컬 모델은 Ollama를 실행하고 텍스트 생성이 가능한 모델을 내려받으면 계정 연결 없이 탐색할 수 있습니다. 기본 탐색 주소는 http://127.0.0.1:11434이며, 원격 서버나 프록시를 쓰면 providers.ollama.settings.baseURL에 /v1을 포함한 주소를 지정합니다. LM Studio와 vLLM도 로컬 탐색 대상입니다. 완전한 오프라인 실행 여부는 설치·모델 다운로드·외부 도구까지 포함한 환경에서 별도로 시험해야 합니다.

무료 도구와 Console·Go의 모델 비용을 나눠 봅니다

OpenCode 소프트웨어는 무료로 사용할 수 있지만, 모델을 호출하는 비용은 연결 경로에 따라 발생합니다. 예전 Zen 문서 주소는 OpenCode Console 모델 문서로 연결되며, Console은 다른 제공자와 함께 선택할 수 있는 서비스입니다. 유료 모델을 일반 선불 방식으로 쓰면 충전 잔액에서 사용량만큼 차감됩니다.

10월 15일 확인한 Go 공식 요금표는 Go 월 $10, Go Plus 월 $40을 표시합니다. $는 공식 페이지의 표기를 유지했으며, 세금·결제 수수료를 포함한 최종 청구액은 확인하지 않았습니다.

연결 경로	비용 구조	적용 조건
제공자 직접 연결	해당 제공자의 API·계정 요금	제공자별 모델 접근 권한과 이용 한도 적용
Console 일반 선불 사용	충전 잔액에서 사용량만큼 차감	모델별 토큰 단가 적용, Go 구독과 구분
Go	월 10달러	구성원 1명의 워크스페이스, 모델별 포함 사용 한도
Go Plus	월 40달러	구성원 1명의 워크스페이스, Go보다 높은 모델별 한도

Go를 구독한 워크스페이스에는 구성원을 초대할 수 없습니다. Go는 선택 구독입니다. 구독할 경우 Console에서 받은 Go API 키를 /connect에 등록합니다.

Go의 유료 모델 사용량은 모델별 월 달러 환산 한도를 기준으로 계산합니다. 5시간에는 월 한도의 20%, 주간에는 50%, 월간에는 100%가 적용되어 세 시간 범위의 제한을 함께 받습니다. 모델별 한도가 달라 구독료만으로 요청 횟수를 정할 수 없으며, 공식 표의 요청 수는 토큰 사용량을 가정한 추정치입니다. 한시 무료 모델에는 별도 조건이 적용됩니다. Console 잔액을 초과 사용에 쓰는 옵션을 켜면 구독 한도 소진 후 종량제 잔액에서 비용이 차감됩니다.

충전 수수료와 자동충전 기본값에는 문서 간 차이가 남아 있습니다. Console Billing 안내와 앞의 Models 안내가 서로 다른 수수료율·자동충전 조건을 표시하므로 하나의 확정 금액을 제시하기 어렵습니다. 결제 전에는 Settings > Billing의 실제 결제 금액과 자동충전 설정을 확인합니다.

데이터 보존과 학습 사용 여부도 모델별 조건입니다. Go의 Privacy 표는 Gemini 4 Argon Contributor의 입력·출력이 학습에 쓰일 수 있고, Claude Haiku 5.5 요청은 30일 보존된다고 명시합니다. Console의 무료 모델에도 별도 예외가 있습니다. 사내 코드를 보낼 때는 선택 모델의 Privacy 항목과 적용 지역을 함께 확인하는 편이 좋습니다.

V2 에이전트는 작업 지시와 실행 권한을 따로 설정합니다

V2 에이전트 문서의 내장 프로필은 Build·Plan·General·Explore입니다. Build는 기본 코딩 작업, Plan은 탐색과 계획을 맡고, General과 Explore는 하위 세션에서 실행됩니다. Plan은 일반 프로젝트 파일을 편집하지 않지만 요청받은 OpenCode 계획 파일은 쓸 수 있고, 셸 명령은 권한 규칙을 따릅니다.

사용자 지정 에이전트는 프로젝트의 .opencode/agents/<name>.md 또는 전역 ~/.config/opencode/agents/<name>.md에 둡니다. JSON 설정에서는 agents 아래에 정의하며, 작업 지시는 system, 실행 허용 여부는 permissions 배열로 작성합니다. 각 규칙은 동작인 action, 적용 대상인 resource, 허용·확인·거부를 뜻하는 effect로 구성됩니다.

다음은 opencode.json에 파일 수정과 셸 실행을 거부하는 검토용 하위 에이전트를 정의한 V2 문법 예시입니다. model을 생략한 하위 에이전트는 부모 세션의 모델을 물려받습니다. 예시를 실제 실행한 결과는 없습니다.

json복사

{
  "agents": {
    "reviewer": {
      "description": "Reviews changes without editing files or running shell commands",
      "mode": "subagent",
      "system": "Review the current changes and report findings.",
      "permissions": [
        { "action": "edit", "resource": "*", "effect": "deny" },
        { "action": "shell", "resource": "*", "effect": "deny" }
      ]
    }
  }
}

권한 규칙은 순서대로 적용되며 마지막으로 일치한 규칙이 우선합니다. 전역 권한 뒤에 에이전트별 권한이 적용되므로 개별 규칙 한 줄보다 최종 설정 전체가 실행 범위를 결정합니다. system에 작업 지시를 적는 것과 도구 실행 권한을 제한하는 것은 별도 설정입니다.

MCP 서버는 외부 도구 연결을 확장합니다. V2 이행 문서의 MCP 설정은 서버를 mcp.servers 아래에 두도록 안내합니다. 모델 제공자 연결과 MCP 서버 연결은 따로 구성하며, V1 플러그인은 새 플러그인 API에 맞춰 옮겨야 합니다.

여러 제공자를 쓰려는 개발자에게 필요한 선택 기준

OpenCode는 프로젝트마다 모델 제공자를 바꾸거나 로컬 모델을 연결하고, 에이전트별 실행 권한을 관리하려는 개발자에게 선택지가 됩니다. 도입할 때는 필요한 모델의 접근 권한을 확보할 수 있는지, 기존 설정과 플러그인을 관리할 수 있는지가 판단 기준입니다. 터미널 외에도 데스크톱·웹 인터페이스가 있어 화면 선택은 작업 환경에 맞출 수 있습니다.

V1의 LSP 진단이 작업의 필수 조건이라면 V2 전환 전에 린트·타입 검사로 같은 검증을 할 수 있는지 확인하는 편이 좋습니다. 코드 보존 정책이나 월 지출 상한이 엄격한 프로젝트에서는 선택 모델의 데이터 처리 조건과 Go 초과 사용·자동충전 설정도 도입 조건에 포함됩니다. 실제 작업의 정확도와 비용은 사용할 모델·프로젝트·권한을 정한 뒤 작은 변경 작업으로 시험할 수 있습니다.

자료 확인 기준: 2026년 10월 15일. 버전별 기능·요금·모델 제공 및 데이터 처리 조건은 변경될 수 있습니다.

도입 비용을 함께 계산하는 가이드

가이드바이브 코딩

AI 코딩 도구 9종 가격 가이드: 무료 한도와 추가 요금 (2026년 10월)

Claude·Cursor·Codex 등 AI 코딩 도구 9종의 요금을 2026년 10월 15일 공식 자료로 확인했습니다. 무료 한도, 월·연 결제, 팀 청구 단위와 구독 외 사용료를 구분합니다.

정성준2026. 4. 3.