OpenCode

어떤 작업에 쓰는 도구인가

OpenCode는 기존 저장소를 파악하거나 버그 수정, 기능 추가, 리팩터링을 진행하는 개발자에게 적합합니다. 웹 채팅에 코드를 매번 붙여 넣는 대신 프로젝트 파일을 대상으로 질문하고 변경 작업까지 이어갈 수 있습니다.

다만 생성된 수정이 요구사항을 충족하는지는 개발자가 변경 내역과 테스트 결과로 확인해야 합니다. 모델 선택과 제공한 문맥에 따라 답변 품질도 달라집니다.

지원 OS와 버전 검토

공식 다운로드 페이지는 macOS Apple Silicon·Intel, Windows x64, Linux의 .deb·.rpm 배포를 안내합니다. 따라서 제공된 macOS 분류는 맞지만 macOS 전용 제품은 아닙니다.

공식 변경 기록과 GitHub 배포 페이지에서 2026년 10월 6일의 v1.18.35를 확인했습니다. 동시에 홈페이지 설치 안내는 V2 경로를 사용하고 별도 V2 문서도 제공합니다. 설치 명령과 기능 설명은 사용하는 계열의 문서에 맞춰 확인해야 합니다. 확인한 자료에서는 제품 전체의 지원 종료 공지를 찾지 못했습니다.

설치와 첫 작업 순서

Mac에서는 공식 다운로드 페이지에서 칩 종류에 맞는 데스크톱 파일을 선택합니다. Homebrew를 사용하는 경우 공식 안내의 brew install --cask opencode-desktop도 선택지입니다.

첫 작업은 모델 제공자 연결, 프로젝트 선택, 작은 코드 설명 요청 순서로 시작하는 것이 좋습니다. V1 터미널의 문서상 절차는 프로젝트 폴더에서 opencode 실행 → /connect로 제공자 인증 → /init으로 프로젝트 분석입니다. /init은 루트에 AGENTS.md를 생성하므로 기존 파일과 생성 내용을 확인합니다. 이 절차는 사용 안내이며 실제 설치나 실행을 수행한 것은 아닙니다.

실무 예시: 로그인 오류 수정

예를 들어 로그인 후 설정 화면에서만 인증이 실패한다면, 먼저 관련 파일을 지정해 정상 화면과 인증 처리의 차이를 설명하도록 요청합니다. V1 터미널에서는 @로 파일을 검색해 질문에 포함할 수 있습니다.

Plan에서 원인 후보와 수정 범위, 재현 방법을 검토한 뒤 Build에 수정 작업을 맡깁니다. 이후 정상 로그인과 만료된 세션을 각각 테스트하고 변경 파일을 검토합니다. V1의 /undo는 의도와 다른 에이전트 변경을 되돌리는 데 사용할 수 있습니다.

무료 모델과 유료 이용의 차이

공식 홈페이지는 무료 모델을 포함한다고 안내하며, Zen 가격표에도 무료 모델이 있습니다. 그러나 일부는 한시적 제공이고 데이터가 모델 개선에 사용될 수 있으므로 업무 코드를 보내기 전에 모델별 조건을 확인해야 합니다.

Zen은 선택 사항인 사용량 기반 서비스로 모델별 토큰 요금이 다릅니다. Go는 월 10달러, Go Plus는 월 40달러이며 모델별 이용 한도가 있습니다. 한도 초과 시 Zen 잔액 사용 옵션을 켜면 추가 잔액이 소비될 수 있습니다. 외부 제공자를 직접 연결하면 그 제공자의 과금·접근 조건도 적용됩니다.

문제가 생겼을 때 확인 순서

데스크톱 화면이 멈추거나 비어 있으면 앱을 완전히 종료하고 다시 실행합니다. macOS에서는 OpenCode 메뉴의 Reload Webview도 확인합니다. 계속 문제가 있으면 오류 내용을 확보하고 플러그인, 캐시, 서버 설정 순으로 원인을 좁힙니다.

인증 실패는 /connect 재인증, API 키 유효성, 제공자 API로의 네트워크 연결을 확인합니다. 모델을 찾지 못한다면 인증 상태와 providerId/modelId 형식, 계정의 모델 접근 권한을 점검합니다. macOS 로그는 ~/.local/share/opencode/log/에 있습니다. 저장소 초기화는 세션·인증 데이터 손실 가능성을 확인한 뒤 마지막 수단으로 검토합니다.

다른 도구와 선택 기준

Claude Code 같은 코딩 에이전트와 비교할 때는 여러 제공자와 로컬 모델을 연결해야 하는지, 소스 공개 여부가 중요한지, 터미널·데스크톱 중 어떤 작업 방식이 편한지를 기준으로 살펴볼 수 있습니다.

Cursor 같은 편집기 중심 도구와 비교한다면 현재 IDE를 유지하면서 OpenCode를 별도 앱이나 확장으로 붙이는 구성이 적합한지 검토합니다. 도입 전에는 작은 실제 과제로 수정 품질, 검토 편의성, 모델 비용을 비교하는 것이 좋습니다.

공식 안내

• OpenCode | The open source AI coding agent · 확인 2026-10-09
• OpenCode | Download · 확인 2026-10-09
• Intro | AI coding agent built for the terminal · 확인 2026-10-09
• Intro | OpenCode — V2 · 확인 2026-10-09
• Agents | OpenCode — V2 · 확인 2026-10-09
• Troubleshooting | OpenCode · 확인 2026-10-09
• Zen | OpenCode · 확인 2026-10-09
• Go | OpenCode · 확인 2026-10-09
• OpenCode | Changelog · 확인 2026-10-09
• Release v1.18.35 · anomalyco/opencode · 확인 2026-10-09