OpenCode: 터미널용 AI 강화 에이전트
Source: Dev.to

OpenCode란?
OpenCode는 터미널용으로 설계된 오픈 소스 코드 에이전트로, 명령줄에서 직접 AI와 함께 코딩할 수 있게 해줍니다. 다른 폐쇄형 도구와 달리 OpenCode는 단일 바이너리 형태로 의존성이 없으며(Node.js나 Python이 필요 없음) 에이전트 시스템, 스킬(skills) 및 맞춤형 명령어가 돋보입니다.
왜 사용해야 할까요?
OpenCode의 철학은 유연성과 구조에 기반합니다. 여기 사용해볼 주요 이유를 소개합니다:
- 모델에 구애받지 않음: Anthropic, OpenAI, Google Vertex 등 75개 이상의 공급자를 지원하며, Ollama와 같은 로컬 옵션도 포함됩니다. 현재 GitHub Copilot 또는 ChatGPT Plus 구독을 사용해 추가 API 비용 없이 이용할 수 있습니다.
- 오류 복구 (Self‑healing): 작업 상태를 추적하기 위해 JSON 매니페스트를 사용합니다. 문제가 발생하면 시스템이 해당 지점에서 재개하거나 자동으로 수정할 수 있습니다.
- 프라이버시와 비용: 로컬 모델을 인터넷 없이 실행할 수 있어 네트워크 지연과 토큰 비용을 없앨 수 있습니다.
빠른 비교
| 특징 | OpenCode | Claude Code |
|---|---|---|
| 환경 | 콘솔 TUI | 콘솔 CLI |
| 모델 지원 | 75개 이상 공급자 | Claude 모델만 |
| 구성 | JSON / Markdown | 순수 Markdown |
| 복구 | JSON 매니페스트 | 기본 오류 처리 |
| 비용 | 무료 (API 키 비용만 지불) | 고정 구독 |
한 번에 설치
OpenCode를 설치하는 것은 매우 간단합니다. 터미널에서 다음 명령을 실행하기만 하면 됩니다:
curl -fsSL https://opencode.ai/install | bash
스크립트가 자동으로 운영 체제와 아키텍처를 감지하고, 바이너리를 /usr/local/bin에 설치합니다.
작업 흐름: Plan vs Build
OpenCode는 다양한 권한 수준을 가진 에이전트 시스템을 가지고 있으며, 주로 Plan과 Build가 있습니다:
- Plan 모드 (탐색): 안전 모드입니다. 에이전트는 코드를 읽고 분석하여 이해하지만 아무 것도 수정하지 않습니다.
- Build 모드 (실행): 실행 모드입니다. 여기서 AI는 파일을 작성·수정하고 명령을 실행하여 계획을 구현할 수 있습니다.
Pro‑tip: 인터페이스에서 Tab 키를 눌러 두 모드 사이를 전환할 수 있습니다.
명령 및 에이전트를 통한 자동화
OpenCode는 질문에 답하는 데 그치지 않고, 반복 작업(예: 테스트 실행이나 PRD 생성)을 위한 맞춤 명령과 특정 역할(예: 보안 아키텍트 또는 문서 전문가)을 위한 전문 에이전트를 만들 수 있게 해줍니다.
예를 들어, 다른 에이전트를 조정하여 Mermaid 다이어그램을 자동으로 생성하고, 아키텍처를 분석하며, 프로젝트의 README를 하나의 흐름으로 업데이트하는 오케스트레이션 에이전트를 설정할 수 있습니다.
결론
OpenCode의 핵심은 모든 것을 사용하려는 것이 아니라, 지루한 작업을 지능형 에이전트에게 언제 위임하고 당신은 중요한 일, 즉 비즈니스 로직에 집중할지 아는 것입니다. 이것은 당신과 함께 성장하는 도구이며, 더 많은 스킬(skills)과 맞춤형 에이전트를 만들수록 작업 흐름이 더 효율적이 됩니다.
시작할 준비가 되셨나요? 터미널을 열고 프로젝트에서 /init를 실행하여 에이전트 팀이 당신을 위해 작업하는 힘을 발견하세요.
