
OpenCode — 모델 락인 없는 무료 코딩 에이전트, 깃허브 20만 스타의 비밀
"코딩 에이전트 쓰고 싶은데, 매달 구독료가 부담돼요."
2026년, 그 고민을 한 방에 해결한 프로젝트가 등장했습니다. OpenCode(오픈코드)입니다. 깃허브 스타 20만 개, 월간 사용자 1,600만 명, 기여자 950명 이상. 마케팅 예산 없이, 개발자들 사이의 입소문만으로 이 숫자를 만들었습니다.
비결은 간단합니다. 완전 무료, 완전 오픈소스, 그리고 어떤 AI 모델이든 골라 쓸 수 있다는 거죠.
OpenCode가 뭔가요?
한 문장으로 정리하면, 내 컴퓨터에서 돌아가는 오픈소스 AI 코딩 에이전트입니다.
Claude Code, Cursor, GitHub Copilot 같은 상용 코딩 도구와 같은 일을 하지만, 핵심 차이가 있습니다:
비교 Claude Code Cursor OpenCode
| 가격 | 월 $20~ | 월 $20~ | 무료 (API 비용만) |
| AI 모델 | Claude만 | 제한적 선택 | 75개 이상 자유 선택 |
| 소스 코드 | 비공개 | 비공개 | 완전 공개 (MIT) |
| 데이터 보관 | 서버 전송 | 서버 전송 | 내 컴퓨터에만 저장 |
| 실행 환경 | 터미널 | IDE (VS Code) | 터미널·데스크톱·IDE·웹 모두 |
핵심은 **"모델 락인이 없다"**는 점입니다. Claude Code는 Claude만, Cursor는 특정 모델만 쓸 수 있지만, OpenCode는 OpenAI·Google·Mistral·DeepSeek부터 내 컴퓨터에서 돌리는 로컬 모델(Ollama)까지 75개 이상의 AI 모델을 자유롭게 바꿔 쓸 수 있습니다. 설정 파일 한 줄만 바꾸면 됩니다.
실제로 뭘 할 수 있나요?
OpenCode는 단순한 코드 자동완성이 아닙니다. 에이전트입니다. 스스로 계획하고, 코드를 쓰고, 테스트하고, 에러를 고칩니다.
Plan 모드: "로그인 기능을 만들어줘"라고 지시하면, OpenCode가 먼저 계획을 세워서 보여줍니다. 계획이 마음에 들면 Build 모드로 전환해서 실행합니다.
LSP 통합: 코드를 쓴 뒤 컴파일러의 에러 메시지를 AI가 직접 읽고, 알아서 수정합니다. 사람이 에러를 복사·붙여넣기 할 필요가 없어요.
실행 취소·재실행: /undo로 변경을 되돌리고, /redo로 다시 적용할 수 있습니다. 실수해도 안전합니다.
MCP 서버 연결: 데이터베이스, API, 외부 도구를 MCP로 연결하면 코드를 쓰면서 실제 데이터에 접근할 수 있습니다.
세션 관리: 여러 작업을 분리된 세션으로 관리할 수 있어서, 프로젝트 A와 프로젝트 B가 섞이지 않습니다.
5분 만에 시작하기
1단계: 설치
터미널에서 한 줄이면 됩니다: npm install -g opencode
Node.js가 필요합니다 (nodejs.org에서 무료 설치).
2단계: AI 모델 연결
OpenCode를 실행하면 설정 마법사가 나옵니다. 사용할 AI 모델의 API 키를 입력하세요.
추천 시작 조합:
- 저렴하게: DeepSeek API ($0 무료 크레딧으로 시작)
- 균형 잡히게: OpenAI GPT-4o mini (가성비 좋음)
- 로컬에서 무료로: Ollama + Llama 3 (인터넷 없이 동작, 완전 무료)
3단계: 프로젝트 초기화
프로젝트 폴더에서 opencode 실행 후, init을 입력하면 프로젝트 구조를 분석해서 AGENTS.md 파일을 자동 생성합니다. 이 파일이 OpenCode의 프로젝트 기억 역할을 해요.
4단계: 작업 시작
자연어로 지시하면 됩니다:
- "이 프로젝트 구조를 분석해줘"
- "@파일명 이 함수의 버그를 찾아줘" (@으로 파일을 지정)
- Tab 키로 Plan 모드 ↔ Build 모드 전환
Zen 플랜 — 모델 고민 없이 시작하기
"AI 모델이 75개라는데, 뭘 골라야 할지 모르겠어요."
이런 분을 위해 Zen 플랜이 있습니다. 월 $5(첫 달)부터 시작하며, OpenCode 팀이 코딩 에이전트에 최적화된 모델을 미리 테스트해서 골라줍니다. API 키를 직접 관리하기 싫은 분에게 추천합니다.
물론 Zen 없이도 OpenCode는 완전히 무료로 쓸 수 있습니다. 자기 API 키만 있으면 됩니다.
코딩 초보자도 쓸 수 있나요?
쓸 수 있습니다. 다만 OpenCode는 기본적으로 터미널 기반이라, 터미널에 익숙하지 않은 분은 처음에 낯설 수 있어요.
초보자를 위한 대안:
- 데스크톱 앱: Mac·Windows·Linux용 데스크톱 앱이 있어서, 터미널 없이도 쓸 수 있습니다
- VS Code 확장: VS Code에 설치하면 에디터 안에서 바로 사용 가능
- 모바일 앱: Android용 오픈소스 앱으로 스마트폰에서도 접속 가능
"코드를 배우고 싶은데, AI한테 도와달라고 하고 싶다" → OpenCode가 코드를 쓰는 과정을 보면서 배울 수 있어요. /undo로 안전하게 실험할 수 있으니 부담도 없습니다.
⚠️ 알아둘 점
첫째, 현재 Anthropic(Claude) 모델은 공식 지원하지 않습니다. 2026년 1월 Anthropic이 OpenCode의 Claude 접근을 차단했습니다. 대신 GPT·Gemini·DeepSeek 등 다른 모델을 쓸 수 있고, 커뮤니티에서는 오히려 GPT-5.4와 Gemini 3.1이 코딩에 더 좋다는 평가도 많습니다.
둘째, 무료라고 비용이 0원은 아닙니다. OpenCode 자체는 무료지만, API 사용료는 선택한 모델에 따라 나갑니다. 다만 DeepSeek 무료 크레딧이나 Ollama 로컬 모델을 쓰면 정말로 0원입니다.
셋째, AI가 만든 코드는 반드시 검토하세요. 어떤 코딩 에이전트든 마찬가지입니다. 특히 프로덕션에 배포하기 전에는 사람이 최종 확인해야 합니다.
📌 오늘의 핵심 요약
- OpenCode는 깃허브 20만+ 스타, 월 1,600만 사용자의 오픈소스 AI 코딩 에이전트입니다.
- 핵심 차별점은 75개 이상 AI 모델 자유 선택, 완전 무료(MIT 라이선스), 내 데이터 내 컴퓨터에만 보관입니다.
- 터미널·데스크톱·IDE·웹 어디서든 쓸 수 있고, 5분이면 설치 완료됩니다.
- Plan 모드로 계획을 세우고, Build 모드로 실행하고, /undo로 안전하게 되돌릴 수 있습니다.
- 모델 선택이 어려우면 **Zen 플랜($5/월)**으로 추천 모델을 바로 쓸 수 있습니다.
- 현재 Claude 모델은 차단 상태이지만, GPT·Gemini·DeepSeek 등 대안이 풍부합니다.
'AI 에이전트 실전 가이드' 카테고리의 다른 글
| AI 에이전트에게 권한 줄 때 체크리스트 — 가드레일 실전편 (0) | 2026.09.26 |
|---|---|
| Agent Skills 실전 가이드 — 매번 설명 안 해도 AI가 알아서 하는 법 (0) | 2026.09.22 |
| OpenClaw — 깃허브 역사상 가장 빠르게 10만 스타를 찍은 개인 AI 비서 (0) | 2026.09.19 |
| OpenAI Agents API 공개 베타 — 에이전트를 "서비스로" 쓰는 시대 (0) | 2026.09.16 |
| OpenAI GPT-6 Astra 등장 — "코딩·리서치·컴퓨터 사용"까지 하는 새 모델, 뭐가 달라졌나? (0) | 2026.09.16 |