최근 개발자 커뮤니티에서 "모델은 바꿔 쓰되, 에이전트는 하나로"라는 흐름이 뚜렷해졌습니다. 그 중심에 OpenCode가 있고, 터미널에서 저장소를 읽고 수정하고 테스트까지 도는 '에이전트형 코딩'이 더 이상 실험이 아니라는 신호로 보입니다.12 이 글에서는 OpenCode가 뭔지, 왜 뜨는지, 그리고 써볼 때 꼭 알아야 할 포인트를 한 번에 정리해볼게요.
OpenCode란? 오픈소스 AI 코딩 에이전트의 정체
OpenCode는 터미널(TUI) 기반 오픈소스 AI 코딩 에이전트입니다.2 그냥 "코드를 만들어주는 챗봇"이 아니라, 실제로 레포를 훑고(컨텍스트), 작업을 쪼개고(플랜), 파일을 고치고(패치), 명령어를 실행하고(테스트/빌드) 결과를 다시 반영하는 식으로 "일"을 합니다.
여기서 핵심은 OpenCode가 특정 모델에 묶여 있지 않다는 점이에요. OpenAI, Anthropic, Google, 로컬 모델까지 폭넓게 붙일 수 있어 "모델은 상황에 따라 갈아끼우고, 작업 방식은 유지"하는 접근이 가능합니다.3 즉, 개발자가 매번 툴을 갈아타며 적응할 필요가 줄어듭니다.
왜 지금 OpenCode인가: 비용 폭탄과 벤더 락인 탈출구
에이전트형 도구는 편하지만, 한 번 요청에 모델 호출이 수십 번 튀는 경우가 흔합니다. 그러면 토큰 과금이 예측 불가해지고 "이번 달 청구서가 왜 이래?"가 일상이 되죠.4 그래서 요즘 뜨는 해법이 모델 위에 '에이전트 레이어'를 두는 방식입니다. OpenCode 같은 도구가 바로 그 레이어고요.4
또 하나는 벤더 락인 문제입니다. 어떤 도구는 특정 회사 모델에 최적화되어 편하긴 한데, 정책이 바뀌거나 제한이 생기면 그대로 발이 묶입니다. 실제로 커뮤니티에서는 특정 구독 자격 증명을 외부 에이전트에서 쓰는 방식이 막히면서, "어차피 API로 돌아와야 한다"는 이야기가 나왔습니다.4 결국 오래 가는 선택은 "툴은 오픈, 연결은 유연" 쪽에 가깝습니다.
실전 사용법: Plan/Build, AGENTS.md, 그리고 안전장치
OpenCode를 처음 켜면 가장 먼저 하고 싶은 말은 하나입니다. 바로 Build로 달리지 말고, Plan부터 켜세요. OpenCode에는 읽기/분석 중심의 Plan과 실제 변경을 수행하는 Build 흐름이 있어, 계획을 먼저 세우면 '수정 범위 폭주'를 크게 줄일 수 있습니다.3
그다음은 /init로 만드는 AGENTS.md입니다. 이 파일은 "이 레포에서 테스트는 뭘로 돌리고, 코딩 스타일은 무엇이고, 건드리면 안 되는 폴더는 어디인지" 같은 팀 룰을 에이전트에게 고정 지침으로 주는 역할을 합니다. 세션마다 같은 설명을 반복하지 않게 해주고, 결과물의 일관성도 좋아집니다.5
마지막으로 꼭 챙길 게 권한/프롬프트 유출 설정입니다. 커뮤니티에서는 "로컬 모델만 설정했는데도 일부 프롬프트가 클라우드로 나갔다" 같은 경험담이 공유됐고, 기본 '작은 모델' 설정이 의도치 않은 전송을 만들 수 있다는 지적도 있었습니다.6 프로젝트 성격이 민감하다면, 작은 모델/세션 타이틀 생성 같은 부가 호출이 어디로 가는지부터 점검하는 게 안전합니다.
시사점: OpenCode는 '코딩 도구'보다 '워크플로우'에 가깝다
OpenCode를 잘 쓰는 사람과 "생각보다 별론데?" 하는 사람의 차이는 기능이 아니라 습관에서 갈립니다. Plan으로 범위를 잠그고, AGENTS.md로 규칙을 심고, 권한을 보수적으로 시작하면 OpenCode는 "터미널에서 PR까지 가는 지름길"이 됩니다. 반대로 아무 설정 없이 바로 자율 실행에 맡기면, 빠른 만큼 엉뚱한 방향으로도 빨리 달릴 수 있어요.
추천하는 시작 루틴은 간단합니다. 작은 레포에서 Plan으로 구조 설명을 받아보고, /init로 지침을 만들고, 아주 작은 수정(예: 테스트 하나 추가)부터 Build로 시켜보세요. 그 3번만 해도 OpenCode가 내 팀의 생산성을 올릴 타입인지 감이 옵니다.
참고
1OpenCode - Open source AI coding agent
2I found a free, open-source alternative to Claude Code, and it works with everything
3How to Use OpenCode: Quick Start, 7 Practical Tips, and When to Add Oh My OpenCode
4Open-source coding agents like OpenCode, Cline, and Aider are solving a huge headache for developers
5OpenCode Quickstart: Install, Configure, and Use the Terminal AI Coding Agent
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.