🤖 OpenCode가 뭔데? (+ Oh My OpenCode 완전 정복기)

안녕하세요. 트윅히입니다.

오늘은 그렇게 핫하다는 오픈코드와 오픈코드를 활용한 오마이오픈코드까지 알아보도록 하겠습니다.

 

매일매일 새로운 도구들이 쏟아져 나오고 있습니다..!

사실 오픈코드도 새 도구라기엔.. 나온지가 꽤 되었으나ㅠㅠ 그냥.. 묻혀서 넘어가 봅니다.

 

너무 많은 도구들과.. 기술들로 어깨가 무거워요ㅠㅠ

 

 

Claude Code의 오픈소스 대안을 찾고 계신가요? 터미널을 주 무대로 삼는 개발자라면 이 글이 딱입니다.

 

📋 목차

1. OpenCode란 무엇인가요?
2. OpenCode의 주요 특징
3. OpenCode 설치 및 시작하기
4. Oh My OpenCode란 무엇인가요?
5. Oh My OpenCode의 핵심 — Sisyphus 에이전트
6. Oh My OpenCode 설치하기
7. OpenCode vs Claude Code — 무엇이 다른가요?

 

---

OpenCode란 무엇인가요?

요즘 AI 코딩 툴 시장이 정말 빠르게 움직이고 있습니다.

GitHub Copilot, Cursor, Claude Code... 하나씩 따라가기도 벅찰 정도인데요.

그 중에서 최근 개발자 커뮤니티에서 특히 주목받고 있는 툴이 있습니다. 바로 OpenCode입니다. 🐙

 

OpenCode는 터미널에서 동작하는 오픈소스 AI 코딩 에이전트입니다.

github.com/anomalyco/opencode에서 시작해 현재 GitHub 스타 60,000개 이상, 매월 65만 명 이상의 개발자가 활용하고 있는 프로젝트입니다.

한 마디로 정리하면, "Claude Code를 터미널에서, 다양한 AI 모델로, 오픈소스로 쓰고 싶다면 OpenCode" 라고 할 수 있습니다.

---

OpenCode의 주요 특징

🔑 1. 특정 AI 제공사에 종속되지 않습니다

Claude Code는 Anthropic API에만 묶여 있지만, OpenCode는 다릅니다. Claude, OpenAI GPT, Google Gemini, AWS Bedrock, Groq, Azure OpenAI, GitHub Copilot, 심지어 Ollama를 통한 로컬 모델까지 — 원하는 모델을 자유롭게 선택할 수 있습니다.

# 예: GitHub Copilot으로 인증
opencode auth login
# → GitHub 선택 → OAuth 인증

🖥️ 2. 아름다운 TUI (Terminal User Interface)

Bubble Tea 라이브러리로 만들어진 TUI는 단순한 텍스트 출력을 넘어,

vim-like 에디터, 세션 관리, 실시간 스트리밍 출력까지 지원합니다. 터미널에서도 충분히 쾌적한 개발 경험을 제공합니다.

🔒 3. 코드 프라이버시 보장

OpenCode는 코드나 컨텍스트 데이터를 외부 서버에 저장하지 않습니다.

로컬 모델을 사용하면 코드가 외부로 전혀 나가지 않기 때문에, GDPR 규정을 따르거나 코드 보안이 중요한 팀에 특히 적합합니다.

🔌 4. LSP 통합

Language Server Protocol(LSP)을 지원하여 AI 에이전트가 코드 진단(diagnostics), 에러 체크, 린팅 정보를 활용할 수 있습니다. 단순히 코드를 생성하는 것이 아니라, 실제 언어 서버가 바라보는 맥락으로 코드를 이해하고 수정합니다.

// opencode.json 설정 예시
{
  "lsp": {
    "typescript": {
      "disabled": false,
      "command": "typescript-language-server",
      "args": ["--stdio"]
    }
  }
}

⚡ 5. 플러그인 생태계

JavaScript/TypeScript 기반의 플러그인 시스템을 통해 기능을 확장할 수 있습니다. npm 패키지로 배포된 플러그인을 opencode.json에 등록하기만 하면 자동으로 설치·로드됩니다.

---

OpenCode 설치 및 시작하기

설치는 매우 간단합니다. 아래 스크립트 한 줄로 끝납니다.

# 설치
curl -fsSL https://opencode.ai/install | bash

# 또는 npm/bun 사용
npm i -g opencode-ai@latest

# macOS는 brew도 지원
brew install anomalyco/tap/opencode

설치 후 프로젝트 디렉토리에서 opencode를 실행하면 TUI가 열립니다. 처음 실행 시 AI 제공사 인증을 거쳐야 합니다.

# 인증
opencode auth login

# 단일 프롬프트 실행 (non-interactive)
opencode -p "이 함수의 버그를 찾아줘"

기본으로 제공되는 에이전트는 두 가지입니다. build 에이전트는 개발 작업을 위한 전체 접근 권한을 가진 기본 에이전트이고, plan 에이전트는 코드 탐색과 분석을 위한 읽기 전용 에이전트입니다. TUI에서 Tab 키로 에이전트를 전환할 수 있습니다.

---

그럼 이제 오픈코드에 대해서 알아보았으니 

오마이 오픈코드에 대해서 알아보도록 하겠습니다.!!

 

 

Oh My OpenCode란 무엇인가요?

 

OpenCode 자체도 강력하지만, 한 단계 더 나아가고 싶다면 **Oh My OpenCode(OMO)**를 만나보시기 바랍니다. ✨

Oh My OpenCode는 OpenCode 위에서 동작하는 플러그인 형태의 오케스트레이션 레이어입니다. 한국계 개발자 @code-yeongyu가 만든 오픈소스 프로젝트로, 현재 npm 최신 버전은 3.4.0입니다.

"It made me cancel my Cursor subscription. Unbelievable things are happening in the open source community." — Arthur Guiot

핵심 컨셉은 **"배터리 포함(Battery Included)"**입니다. 설치만 하면 다음이 모두 즉시 사용 가능합니다.

• 여러 역할에 특화된 전문 에이전트 11종
• 워크플로우를 자동화하는 40개 이상의 훅(Hooks)
• MCP(Model Context Protocol) 통합 (웹 검색, 문서, 코드 검색)
• 완전한 LSP 및 AstGrep 지원
• Claude Code 호환 레이어

---

Oh My OpenCode의 핵심 — Sisyphus 에이전트

 

OMO의 가장 인상적인 부분은 바로 Sisyphus 에이전트입니다. 그리스 신화의 시시포스처럼, "절대 포기하지 않고 끝까지 일을 완수한다"는 철학을 담고 있습니다. 🪨

"If Claude Code does in 7 days what a human does in 3 months, Sisyphus does it in 1 hour. It just works until the task is done. It is a discipline agent." — B, Quant Researcher

Sisyphus는 단일 에이전트가 아닌, 계층적 멀티 에이전트 오케스트레이터입니다. 내부에서 다음과 같이 동작합니다.

🏗️ 3단계 에이전트 계층

계층 에이전트 역할

Tier 1	Sisyphus, Atlas	메인 오케스트레이터 — 전체 작업 조율
Tier 2	Oracle, Metis, Momus	자문 및 계획 — 쓰기/실행 불가, 분석만
Tier 3	Librarian, Explore, Sisyphus-Junior	실행 및 리서치 전담

🔄 작동 방식

작업을 받으면 Sisyphus는 파일을 직접 뒤지지 않습니다. 대신 더 빠르고 저렴한 모델로 구성된 백그라운드 에이전트들을 병렬로 띄워 코드베이스를 탐색하게 하고, 자신은 핵심 컨텍스트만 유지하며 작업을 조율합니다. 이를 통해 토큰 낭비를 줄이면서도 대규모 코드베이스를 효율적으로 처리할 수 있습니다.

🪝 주요 훅(Hooks)

• Todo Continuation Enforcer : 에이전트가 작업 도중 멈추면 강제로 계속하게 만듭니다. 이게 바로 Sisyphus가 바위를 계속 굴리는 이유입니다.
• Comment Checker : AI가 과도한 주석을 달지 못하게 막아, 코드가 사람이 쓴 것처럼 보이게 합니다.
• Context Window Monitor : 컨텍스트 창이 78% 차면 자동으로 세션 요약을 실행해 토큰 폭발을 방지합니다.

✨ 실제 사용자 경험

"Knocked out 8000 eslint warnings with Oh My Opencode, just in a day"
— Jacob Ferrari

"I converted a 45k line tauri app into a SaaS web app overnight"
— James Hargis

실사용 후기를 보면, 단순한 코드 보조 도구가 아니라 사람이 며칠 걸릴 작업을 하루 만에 해치우는 수준이라는 걸 알 수 있습니다.

---

Oh My OpenCode 설치하기

먼저 OpenCode가 설치되어 있어야 합니다. 그다음 아래 명령어로 플러그인을 추가하면 됩니다.

# Step 1: OpenCode 설치 (이미 설치되어 있다면 생략)
curl -fsSL https://opencode.ai/install | bash

# Step 2: Oh My OpenCode 플러그인 설치
bunx oh-my-opencode install

# 또는 npm으로
npm install -g oh-my-opencode

설치 스크립트가 실행되면 어떤 AI 제공사 구독을 가지고 있는지 대화식으로 물어보며 최적의 모델 설정을 자동 구성해줍니다.

# 설치 완료 후 프로젝트 디렉토리에서 실행
opencode

이후부터는 Sisyphus 에이전트가 기본으로 활성화되어, 프로젝트 구조를 인덱싱하고 본격적인 멀티 에이전트 워크플로우가 시작됩니다.

⚙️ 설정 파일 위치

범위 경로

프로젝트별 설정	.opencode/oh-my-opencode.json
전역 사용자 설정	~/.config/opencode/oh-my-opencode.json

// 설정 예시 (oh-my-opencode.json)
{
  "agents": {
    "atlas": {
      "model": "anthropic/claude-sonnet-4-5",
      "variant": "max"
    },
    "librarian": {
      "model": "google/gemini-flash"
    }
  },
  "experimental": {
    "aggressive_truncation": true
  }
}

⚠️ 주의사항

공식 오픈소스 프로젝트를 사칭하는 유료 사이트가 존재합니다. 반드시 아래 공식 채널에서만 다운로드하시기 바랍니다.

• GitHub: https://github.com/code-yeongyu/oh-my-opencode
• npm: npm install -g oh-my-opencode

---

OpenCode vs Claude Code — 무엇이 다른가요?

많은 분들이 "그럼 Claude Code랑 비교하면 어때요?"라고 물어보십니다. 정리하면 아래와 같습니다.

항목 OpenCode Claude Code

가격	기존 구독 활용 가능 (Copilot, ChatGPT 등)	Anthropic API 종량제
모델 선택	75개 이상 제공사, 로컬 모델 포함	Anthropic 모델 전용
오픈소스	✅ 완전 오픈소스	❌
프라이버시	로컬 모델 사용 시 완전 오프라인 가능	Anthropic 서버 통신
TUI	Bubble Tea 기반, 고도화된 TUI	기본 터미널
SWE-bench	사용 모델에 따라 다름	Claude 모델 기준 80.9%
GitHub Copilot 연동	✅ 공식 파트너십 (2026년 1월)	❌

Claude Code는 성숙한 가드레일과 대형 코드베이스 컨텍스트 처리가 강점이고, OpenCode는 비용 효율성과 모델 유연성, 프라이버시가 강점입니다.

정답은 없습니다. 팀의 상황, 보안 정책, 예산에 따라 최적의 선택이 달라질 것입니다.

---

결론!

OpenCode와 Oh My OpenCode는 "AI 코딩 도구는 특정 회사 제품이어야 한다"는 고정관념을 깨는 프로젝트입니다. 터미널을 사랑하는 개발자라면, 오픈소스의 유연함과 멀티 에이전트의 강력함을 직접 체험해보시길 추천드립니다.

특히 대규모 리팩토링, 레거시 마이그레이션, 모노레포 환경에서 Oh My OpenCode의 Sisyphus는 "이게 정말 되는 건가?" 싶을 만큼 놀라운 결과를 보여준다고 합니다. 👀