OpenCode 리뷰: 무엇이며 어떻게 작동하고 누구에게 적합할까

OpenCode는 Anomaly라는 회사가 만든 무료 오픈 소스 AI 코딩 에이전트입니다. 채팅 창과의 차이는 작업하는 위치입니다. 컴퓨터의 폴더에서 실행하면 그 안의 파일을 읽고 편집하며, 설명한 일을 마치기 위해 명령을 실행합니다.

그 접근 권한이 이 OpenCode 리뷰에서 다루는 핵심적인 이점이자 대가입니다. 코드를 작성하지 않는 사람에게도 유용한 이유이며, 중요한 것을 맡기기 전에 기본 설정을 살펴야 하는 이유입니다. 터미널, 데스크톱 앱 또는 코드 편집기 안에서 실행되며, 무료 모델이나 이미 비용을 지불하는 AI 구독을 사용할 수 있습니다.

요약

OpenCode를 쓸 가치가 있을까요? 새 구독 없이 자기 파일을 다루는 AI 에이전트를 원하는 대부분의 사람에게는 그렇습니다. 무료이며 무료 모델이나 기존 ChatGPT Plus 또는 GitHub Copilot 요금제로 작동합니다. 연결한 모델이 사고를 담당하고 품질의 상한을 결정합니다. 제 평점은 5점 만점에 4점입니다.

조건이 있습니다. 기본 상태에서는 먼저 묻지 않고 파일을 편집하고 명령을 실행합니다. 중요한 파일을 맡기기 전에 승인 요청을 켜고, Plan 모드에서 작업을 먼저 논의하세요. Plan 모드는 계획용이지만 그 자체로 셸 명령에 승인을 요구하지는 않습니다. 결과를 확인해 줄 사람 없이 완전한 앱을 만들고 출시하려면, 안내가 더 충실한 유료 도구로 시작하는 편이 쉽습니다.

4점은 항목별 점수의 평균이 아닙니다. 안전성과 프로젝트 안정성 점수는 더 낮습니다. 승인 요청은 우발적인 변경을 줄이지만 에이전트를 컴퓨터에서 격리하지는 않으며, 새 버전이 나올 때 안정성도 지켜볼 필요가 있습니다.

OpenCode는 어떻게 작동할까?

폴더에서 OpenCode를 열고 원하는 것을 일상적인 말로 설명하면, 그 안의 파일을 읽고 단계를 정하고 파일을 편집하며 명령을 실행해 작업을 마칩니다. 사고는 연결한 AI 모델이 담당합니다. OpenCode는 그 모델에 손을 달아 주는 앱입니다.

따라서 모델은 별도로 선택해야 합니다. OpenCode 홈페이지에는 컴퓨터에서 실행되는 로컬 모델을 포함해 Models.dev를 통한 75개 이상의 LLM 제공업체가 나와 있습니다. 모델을 바꾸면 작업 품질과 비용이 모두 바뀝니다.

모드는 두 가지입니다. 기본값인 Build는 프로젝트 README에서 전체 접근 권한을 가진 에이전트로 설명하며, 파일을 편집하고 명령을 실행합니다. Plan은 분석과 계획에 집중합니다. 현재 에이전트 문서에 따르면 Plan은 기본적으로 계획 디렉터리 밖의 파일 편집을 차단하지만, 셸 명령은 권한 설정을 따릅니다. 명령 승인을 명시적으로 설정하세요. Plan을 선택하는 것만으로 켜지지 않습니다. 최상위 권한 설정은 Plan의 기본 편집 제한도 덮어쓸 수 있습니다.

OpenCode 다운로드 페이지에 나오는 실행 방법은 세 가지입니다.

• 터미널 버전은 명령줄 창에서 실행되며, 클릭하는 대신 지시를 입력합니다.
• 데스크톱 앱은 일반적인 앱 창을 제공하며 macOS, Windows, Linux용으로 내려받을 수 있습니다.
• 편집기 확장 기능을 쓰면 VS Code, Cursor, Zed 같은 코드 편집기 안에서 OpenCode를 사용할 수 있습니다.

OpenCode 비용은 얼마일까?

OpenCode 자체는 무료입니다. 비용을 지불하는 대상은 모델입니다. 제공 기간 동안 무료 모델을 쓰거나, 기존 ChatGPT, GitHub Copilot, GitLab Duo 구독을 연결하거나, 자신의 API 키로 모델 회사에 직접 지불하거나, OpenCode의 Go(월 $10), Go Plus(월 $40), 종량제 Zen을 구매할 수 있습니다.

여섯 가지 방법을 비교했습니다. 확인일은 2026년 10월 11일입니다. 아래 Zen 자동 충전 금액은 v1 문서에 따른 것이며, 현재 Console의 충전 규칙은 설정할 수 있습니다.

“자신의 API 키”란 OpenAI 같은 모델 회사에 가입하고, 발급받은 키를 OpenCode에 붙여 넣은 뒤 사용량에 따라 그 회사에 비용을 내는 것입니다. 요금은 100만 토큰 단위입니다. 토큰은 대략 단어의 일부이므로 긴 문서는 짧은 질문보다 처리 비용이 높으며, 모델에 따라 같은 텍스트도 더 많은 토큰으로 계산될 수 있습니다.

무료 방식에는 두 가지 조건이 있습니다. OpenCode의 Zen 문서는 각 무료 모델을 한정 기간 제공으로 표시하며, 개인정보 항목은 일부 모델에서 무료 기간 동안 수집된 데이터를 사용할 수 있다고 밝혀 모델 개선에 활용할 수 있습니다. NVIDIA의 무료 엔드포인트는 더 나아가 개인정보나 기밀 데이터를 아예 제출하지 말라고 합니다. 제 권고는 고객 파일과 개인적인 정보를 무료 모델에 맡기지 않는 것입니다.

눈에 띄는 공백은 Claude입니다. OpenCode는 더 이상 Claude Pro나 Max 구독을 지원하지 않습니다. 제공업체 문서에 따르면 이를 가능하게 하는 플러그인을 Anthropic이 명시적으로 금지하며, OpenCode는 버전 1.3.0부터 이를 기본 제공하지 않습니다.

카드를 등록하기 전에 Zen 행은 두 번 읽어 보세요. 자동 충전은 끄지 않으면 켜져 있으며, 같은 문서 페이지는 자동 충전 사용 시 설정한 월간 사용 한도보다 Zen에서 더 많은 금액을 청구할 수 있다고 경고합니다. 확실한 상한을 원한다면 한도만 믿지 말고 자동 충전을 끄세요.

비용 및 요금제: 5점 만점에 4점. 무료 또는 추가 비용 없이 시작할 수 있습니다. 무료 방식은 일시적이고 데이터 제공이라는 대가가 있으며, 종량제 비용을 예측하려면 자동 충전을 꺼야 하므로 1점 감점했습니다.

OpenCode의 장점

가장 큰 장점은 선택권입니다. 한 AI 회사에 묶이지 않으며, 더 좋거나 저렴한 모델이 나오는 날 앱과 설정을 유지한 채 바꿀 수 있습니다. 결과를 직접 검토하기 어려운 사람에게 도움이 되는 특성이 두 가지 있습니다. 한 독립 비교에서는 더 철저하게 테스트했고, 계획에 집중하는 Plan 모드도 있습니다.

모델이 사고하므로 품질의 상한도 모델이 정합니다. 독립적인 직접 비교는 도구가 그 위에 무엇을 더하는지 보여 줍니다. 2026년 1월 Builder.io의 Alice Moore는 깨끗하고 동일한 환경에서 같은 Claude Sonnet 4.5 모델로 OpenCode와 Claude Code에 동일한 네 작업을 수행시켰습니다. Claude Code는 총 9분 9초, OpenCode는 16분 20초가 걸렸습니다. 테스트 작성 작업에서 OpenCode는 테스트 94개를 작성하고, 프로젝트의 기존 자동 검사 전체를 뜻하는 전체 테스트 스위트를 실행했습니다. Claude Code는 73개를 작성하고 그것만 확인했습니다. 당시의 단일 시험에 대한 제 해석은, 모델을 같게 유지하면 OpenCode가 느리지만 더 꼼꼼했다는 것입니다.

Plan 모드는 코드를 읽지 못하는 사람이 구현 전에 제안된 작업을 논의하도록 돕습니다. 아무것도 바뀌지 않는다는 보장은 아닙니다. 셸 명령은 권한 설정을 따르고, 설정이 기본 편집 제한을 덮어쓸 수 있습니다. 변경 후 결과를 판단하기 어려운 사람에게는 승인 요청과 백업뿐 아니라 사전 계획 검토도 유용합니다.

프로젝트는 공개되어 있고 활동이 활발합니다. MIT 라이선스로 배포하므로 유료 업무를 포함해 무료로 사용할 수 있고 누구나 코드를 읽을 수 있습니다. 홈페이지는 GitHub 스타 208,000개 이상과 기여자 950명, 월간 개발자 1,600만 명 이상을 보고합니다. 다만 이는 독립 집계가 아니라 OpenCode 자체 수치입니다.

기능 및 모델 선택권: 5점 만점에 5점.

코딩 경험 없이도 OpenCode를 사용할 수 있을까?

자신의 문서, 조사, 데이터 작업에는 가능합니다. 코딩 배경이 없는 사람들도 생산적으로 사용한다고 말합니다. 혼자 소프트웨어를 만들고 출시하려는 경우는 더 어렵습니다. 뒤에 있는 코드를 읽을 수 없을 때 결과가 제대로 작동하는지 아는 것이 가장 큰 장애물이기 때문입니다.

비코딩 활용을 다룬 r/opencodeCLI 스레드에서 코드를 거의 모른다는 소셜 미디어 관리자는 업무 맥락을 한 폴더에 보관하고 OpenCode로 문서 초안, 트렌드 조사, 경쟁 분석, 프로필 검토를 합니다. 같은 스레드의 마케터는 관심을 끄는 문구, 문체, 규칙을 정리한 파일을 제공해 백서, LinkedIn 게시물, YouTube 대본을 작성합니다. 다른 사람들은 부동산 필지 데이터 분석을 설명하며, 한 사람은 Excel로 가져올 CSV 형식의 표를 에이전트에게 만들게 하자고 제안합니다.

이 경험담을 보면 다음과 같은 작업부터 시작하는 것이 합리적입니다.

• 메모와 문체 규칙이 담긴 폴더를 바탕으로 문서를 작성하고 수정하기.
• 조사나 경쟁사 메모를 저장용 파일로 모으기.
• 스프레드시트나 CSV 파일을 정리하고 재구성하거나 요약하기.
• 먼저 복사본에서 시험한다는 조건으로, 폴더 안 파일 이름을 바꾸는 정도의 작은 개인 도구 만들기.

어려운 부분은 다음과 같습니다.

• 터미널 버전은 명령 입력에 익숙할 것을 요구합니다. 데스크톱 앱은 그 문턱을 낮춥니다.
• 설정을 바꾸려면 opencode.json이라는 작은 텍스트 파일을 편집해야 합니다. 아래 안전성 항목에서 붙여 넣을 내용을 정확히 보여 주지만, 새로운 종류의 작업입니다.
• 코드를 확인할 수 없다면 Plan 모드, 승인 요청, 복사본에서 작업하기는 위험을 줄이지만 결과를 검증하지는 않습니다. 결과를 테스트하고, 중요한 데이터를 다루는 것을 출시하기 전에 기술적인 도움을 받으세요.
• 다른 앱과 연결하는 MCP 서버라는 부가 기능은 설정이 까다롭습니다. 초보자 단기 강좌를 다룬 스레드에서 한 댓글 작성자는 설정이 가장 성가신 부분이라고 했고, 강좌 제작자는 설명할 것이 많아서 제외했다고 합니다.

r/vibecoding 스레드에서 기술적 배경이 없는 사람이 자동화를 위해 OpenCode와 Claude Code 중 무엇으로 시작할지 물었습니다. 한 댓글은 완전한 초보자에게 Claude Code를 권했지만, 서두르지 않고 여러 AI 시스템의 작동 방식을 배우려는 사람에게는 OpenCode를 제안했습니다. 제 해석으로는 소프트웨어를 처음부터 만드는 경우에 가장 중요한 조언입니다. 문서와 데이터는 앞서 소개한 실제 사용 경험이 더 나은 안내입니다.

공식 자료는 아니지만 무료 학습 자료도 있습니다. opencode.school은 데스크톱 앱을 중심으로 구성한 AI 코딩 에이전트 입문자용 영어 강좌이며, learnopencode.com은 콘텐츠 제작을 위한 별도 과정을 갖춘 중국어 강좌입니다.

코딩 경험 없는 사용자의 편의성: 5점 만점에 3점.

OpenCode는 안전하게 사용할 수 있을까?

승인을 켠 뒤 백업한 비민감 파일로 시험하는 것은 합리적일 수 있습니다. 그 승인 요청은 보안 샌드박스가 아닙니다. 기본 상태에서 OpenCode의 주 모드는 묻지 않고 파일을 편집하고 명령을 실행합니다. 2026년 1월 공개된 심각도 높은 결함은 수정됐지만, 최초 보고에는 약 두 달 동안 답변이 없었습니다.

권한 페이지는 기본값을 분명히 설명합니다. 아무것도 지정하지 않으면 OpenCode는 허용 범위가 넓은 기본값으로 시작하며, 파일 편집과 명령 실행을 포함한 대부분의 권한은 기본적으로 “allow”입니다. 기본적으로 도구는 프로젝트 밖 경로에 접근하기 전에 묻고, 읽기 도구는 대부분의 .env 파일을 차단하되 .env.example은 허용합니다. 이는 도구 수준 규칙입니다. 승인된 셸 명령은 여전히 비밀 정보를 읽거나 다른 위치의 파일에 영향을 줄 수 있습니다.

실제 파일로 시험할 때 도움이 되는 습관은 다섯 가지입니다.

1. 매번 새 작업을 Plan 모드(터미널 버전에서는 Tab 키)로 시작해 먼저 계획을 읽으세요. 명령 승인도 설정하세요. Plan 모드만으로는 승인을 요구하지 않습니다.
2. 아래의 작은 설정 파일로 승인 요청을 켜세요.
3. 결과를 신뢰할 때까지 폴더 복사본이나 백업한 폴더에서 작업하세요.
4. /undo로 직전의 변경 작업을 되돌릴 수 있지만 조건이 있습니다. 터미널 버전 문서는 파일 변경 관리에 Git을 사용한다고 하므로, 폴더가 Git 저장소(버전 추적이 켜진 폴더)일 때만 작동합니다. 그렇지 않다면 백업 복사본이 되돌리기 수단입니다.
5. --auto로 OpenCode를 시작하거나 명령 팔레트에서 자동 승인을 켜지 마세요. 둘 다 명시적으로 차단되지 않은 모든 요청을 승인합니다.

두 번째 습관을 위해 작업 중인 폴더에 opencode.json이라는 파일을 만들고 다음 내용을 붙여 넣으세요.

{

  "$schema": "https://opencode.ai/config.json",

  "permission": {

    "edit": "ask",

    "bash": "ask"

  }

}

이를 기본 permissions로 사용하려면 같은 권한 설정을 ~/.config/opencode/opencode.json에 추가하세요. 파일이 이미 있다면 전체를 교체하지 말고 설정을 병합하세요. 프로젝트와 에이전트 설정이 이 기본값을 덮어쓸 수 있습니다.

보안 기록의 주요 항목은 CVE-2026-22812이며, 심각도는 10점 중 8.8로 높음입니다. 1.0.216 이전 버전은 암호 없는 로컬 웹 서비스를 조용히 시작했으므로, 컴퓨터의 다른 프로그램이나 방문한 악성 웹사이트가 사용자 권한으로 OpenCode에 명령을 실행시킬 수 있었습니다. 프로젝트 보안 권고는 수정 버전을 1.0.216으로 명시하고, 보고자가 2025년 11월 17일 보안 담당자에게 이메일을 보냈지만 답변받지 못했다고 기록합니다. 권고는 2026년 1월 12일 공개됐습니다. 저는 코드를 감사하는 것이 아니라 사용자 관점에서 읽고 있으며, 사용자가 할 일은 간단합니다. OpenCode를 최신으로 유지하세요. 2026년 9월 28일 출시된 버전 1.18.33에는 이미 이 수정이 포함됐습니다. 그 버전을 현재 최신으로 여기지 말고 최신 공식 릴리스를 설치하세요.

텍스트가 어디로 가는지도 문제의 나머지 절반입니다. OpenCode는 일반적인 사용 중 자사 서비스에 코드나 맥락을 보관하지 않는다고 합니다. 앱은 세션 데이터를 로컬에 저장하고, 클라우드 모델은 요청에 필요한 맥락을 받으며, /share를 사용하면 대화와 관련 데이터가 업로드됩니다. 별도로 세션 첫 메시지는 첨부된 파일이나 이미지를 포함해 세션 제목 작성만 담당하는 두 번째 모델 요청으로 전송됩니다. 2026년 9월 22일의 미해결 GitHub 이슈는 사용자가 동의하지 않으면 그 요청에서 첨부 파일을 제외해 달라고 요구합니다. 바뀌기 전까지는 제목 모델의 데이터 처리 방식을 확인하지 않았다면 첫 메시지에 민감한 첨부를 넣지 마세요. 이후 메시지도 주 모델로 전송되므로 해당 제공업체의 정책도 확인하세요.

안전 및 개인정보 기본 설정: 5점 만점에 3점. 제 판단으로 몇 분의 설정은 우발적인 변경 위험을 줄이지만, 기본값은 신중함보다 속도를 우선하고 2025년 보고에 대한 대응은 느렸습니다.

OpenCode의 아쉬운 점

2026년 3월 OpenCode는 Anthropic의 법적 요청 이후 Claude 구독용 내장 로그인을 제거했습니다. 4개월 뒤에는 개편된 디자인 때문에 한 Hacker News 스레드에서 기존 사용자 두 명이 불만을 제기했고, 한 명은 이전 버전으로 돌아갔습니다. 약점은 예측 가능성입니다.

Claude 지원 중단은 Anthropic 측에서 비롯됐습니다. 2026년 2월 The Register는 Anthropic이 1월에 단속을 시작한 뒤, Claude 구독을 사용하는 타사 앱 금지를 명시하려고 법적 약관을 개정했다고 보도했습니다. 2026년 3월 19일 OpenCode는 “anthropic legal requests”라는 변경을 병합해 내장 Anthropic 로그인 플러그인과 기타 Anthropic 언급을 제거했습니다. Claude 모델은 여전히 작동하지만 Claude 구독으로는 사용할 수 없습니다. 자신의 Anthropic API 키, OpenCode의 Zen, Vercel AI Gateway 같은 게이트웨이를 통해 사용량만큼 지불하거나, 유료 GitHub Copilot 요금제에 포함된 Claude 모델을 월간 사용량 한도 안에서 사용할 수 있습니다. 제 생각에는 다른 회사의 호의에 의존하는 도구는 하룻밤 사이에 기능을 잃을 수 있으며, OpenCode가 여러 제공업체를 지원하는 설계 덕분에 이 기능을 잃은 뒤에도 다른 방법이 남았습니다.

디자인 개편도 변동의 원인입니다. 2026년 7월 Hacker News 스레드에서 새 인터페이스로 업데이트한 한 사용자는 안전한 병렬 작업 지원이 사라지고 세션 전환이 예전처럼 작동하지 않아 다시 이전 버전으로 내렸습니다. OpenCode 팀원은 워크스페이스 지원을 다시 만들고 있으며, “엄청난 잡음과 스팸을 처리한다”는 이유로 GitHub 이슈를 따라가기 어렵다고 답했습니다. 다른 사용자도 같은 상황이며 OpenCode를 한동안 일상적인 주력 도구로 사용해 왔다고 했습니다.

문서도 뒤처집니다. 2026년 9월 29일 OpenCode 제공업체 문서는 해당 플러그인을 더 이상 기본 제공하지 않는다는 안내 바로 몇 줄 위에서 여전히 “Claude Pro/Max option”을 설명했습니다. 잦은 릴리스는 빠른 수정을 제공하지만 익숙한 것들도 바꿉니다.

프로젝트 안정성 및 이력: 5점 만점에 3점.

OpenCode를 써야 할 사람과 그렇지 않은 사람

OpenCode는 자기 파일을 다룰 에이전트를 원하며, 친절한 안내보다 비용과 선택권을 중시하는 사람에게 적합합니다. 도구 자체가 소프트웨어 만드는 법을 가르쳐야 하거나, 이미 비용을 내는 AI 구독이 Claude라면 덜 적합합니다.

다음 중 하나에 해당한다면 설치해 보세요.

• 이미 ChatGPT Plus나 GitHub Copilot을 구독하며, 추가 비용 없이 문서, 조사, 스프레드시트를 다루는 에이전트를 원합니다.
• 민감하지 않은 작업에서 무료로 에이전트를 시험하고 싶으며, 먼저 승인 요청을 켤 생각입니다.
• 도구를 바꾸지 않고 AI 회사나 모델을 바꾸고 싶습니다.

두 경우에는 다른 곳에서 시작하세요. 결과를 확인할 사람 없이 혼자 완전한 앱을 만들고 출시하려면 Claude Code로 시작하세요. Anthropic이 설정을 더 많이 처리해 주므로 OpenCode보다 시작하기 쉽습니다. 이미 구독하는 Claude Pro나 Max를 이용하려고 알아보는 것이라면 OpenCode는 더 이상 지원하지 않으므로 목적에 맞지 않습니다.

어느 쪽에도 딱 맞지 않는다면 Aider, Cline, Continue 같은 같은 분야의 다른 에이전트는 제어와 편의 사이에서 서로 다른 절충을 제공합니다.

자주 묻는 질문

OpenCode는 OpenClaw와 같은 것인가요?

아닙니다. OpenCode는 컴퓨터의 프로젝트 폴더 안에서 작동하는 코딩 에이전트입니다. OpenClaw는 채팅 앱, 도구, 예약 작업을 연결하는 별도의 상시 실행 비서이며, 작업에 무엇이 필요한지는 코딩 에이전트와 비서 게이트웨이의 차이가 결정합니다.

OpenCode는 예전 opencode 프로젝트나 Crush와 같은 것인가요?

아닙니다. Go로 작성된 예전 github.com/opencode-ai/opencode 프로젝트는 보관 처리됐으며, 원래 작성자와 Charm 팀이 개발하는 Crush라는 이름으로 이어지고 있습니다. Anomaly가 만든 OpenCode의 주소는 opencode.ai와 github.com/anomalyco/opencode입니다. 비슷해 보이는 다른 도메인은 공식 사이트가 아닙니다.

파일을 AI 회사에 보내지 않고 OpenCode를 사용할 수 있나요?

Ollama, LM Studio, llama.cpp 같은 도구로 로컬 모델을 연결하면 가능합니다. 다만 컴퓨터에 모델을 실행할 충분한 메모리가 필요합니다. 제목 생성도 로컬 모델을 쓰는지 확인하세요. small_model과 명시적인 제목 에이전트 모델 재정의 설정을 확인하세요. 세션 공유를 끄고, 로컬 전용 구성으로 간주하기 전에 MCP 서버나 기타 외부 연동도 검토하세요.