✍🏻 Open Code와 Oh-my-opencode

0. 개요

사내에서 opencode와 oh-my-opencode에 대해 알게 되어, 간단하게 실사용을 해보고 소개를 해드리고자 작성한 글입니다.

이 문서는 opencode와 oh-my-oepncode에 대한 간단한 소개와 활용 예시를 담고 있습니다.

1. 소개

1-1. OpenCode란?

OepnCode는 터미널 인터페이스, 데스크톱 앱, IDE 확장 프로그램의 세 가지 형태로 제공되는 AI 코딩 에이전트입니다.

공식 문서

https://opencode.ai/docs/

1-2. oh-my-opencode란?

OpenCode 위에서 동작하는 플러그인으로,

여러 전문 AI 에이전트를 백그라운드에서 병렬로 실행하며 실제 개발 ‘팀’ 처럼 작업을 분담, 완주하게 만드는 도구입니다.

공식 git

https://github.com/code-yeongyu/oh-my-opencode?tab=readme-ov-file#oh-my-opencode

1-3. AI 에이전트 패러다임의 전환

기존 AI 코딩 도구

• 한 모델이 설계, 구현, 디버깅 등 모두 처리
• 컨텍스트가 커질수록 성능 저하
• 중간에 작업이 멈추거나 TODO를 남기고 종료
• IDE 수준의 도구 (LSP, 리팩토링 등)를 에이전트가 활용하지 못함

→ opencode + oh-my-opencode: ‘에이전트 오케스트레이션’을 이용해 한 프로젝트에서 여러 에이전트를 동시에 실행하며 위 문제를 해결합니다.

1-4. oh-my-opencode의 에이전트 팀 구조

oh-my-opencode는 각 영역에 특화된 에이전트 팀을 제공하며,

각 에이전트는 해당 작업에 최적화된 모델을 사용합니다.

마치 위 그림처럼, 개발자가 Sisyphus에게 일을 전달하면 → Sisyphus가 각각의 전문 에이전트에게 작업을 분담합니다.

oh-my-opencode의 매력적인 점은, 이렇게 각 에이전트가 병렬적으로 작업을 백그라운드에서 실행한다는 점입니다.

각 전문 에이전트는 Sisyphus를 통해 호출할 수도 있고, 몇몇 에이전트는 키워드를 사용해 직접 호출할 수도 있습니다. (ex. @librarian 키워드를 이용해 Librarian을 직접 호출)

에이전트	역할	호출방법
Sisyphus	메인 오케스트레이터	기본 활성화
Libraroan	공식 문서 탐색, 코드 리서치	@librarian
Explore	초고속 코드베이스 탐색	@explore
Frontend UI/UX Engineer	프론트엔드 개발 전문	자동 호출
Document Writer	README, API 문서, 가이드 작성	자동 호출
Multimodal Looker	PDF, 이미지, 다이어그램 분석	자동 호출

oh-my-opencode에서 각각의 역할에 맞는 에이전트가 아래와 같이 초기 세팅되어 있으며, 직접 설정도 가능합니다.

// ~/.config/opencode/oh-my-opencode.json
// ~ 위 내용 생략 ~
"agents": {
    "Sisyphus": {
      "model": "opencode/glm-4.7-free"
    },
    "librarian": {
      "model": "opencode/glm-4.7-free"
    },
    "explore": {
      "model": "google/antigravity-gemini-3-flash"
    },
    "frontend-ui-ux-engineer": {
      "model": "google/antigravity-gemini-3-pro-high"
    },
    "document-writer": {
      "model": "google/antigravity-gemini-3-flash"
    },
    "multimodal-looker": {
      "model": "google/antigravity-gemini-3-flash"
    }
  }

2. 설치와 간단한 활용 예

2-1. opencode 설치

macOS / Linux

// 기본 설치 (권장)
curl -fsSL https://opencode.ai/install | bash

// Homebrew를 이용해 설치
brew install sst/tap/opencode

Windows

// Chocolatey를 이용해 설치
choco install opencode

// Scoop을 이용해 설치
scoop install opencode

공통: npm / Docker를 이용해 설치

// npm을 이용해 전역 환경에 설치
npm install -g opencode-ai

// pnpm, yarn bun도 지원 (각각 명령어는 아래와 같음.)
pnpm add -g opencode-ai
yarn global add opencode-ai
bun add -g opencode-ai

2-2. oh-my-opencode 설치

• 설치 이전에 opencode가 먼저 설치가 되어있어야 합니다.

//bunx를 이용해 설치
bunx oh-my-opencode install

//npx를 이용해 설치
npx oh-my-opencode install

opencode가 설치된 상태에서 명령어 입력 시

claude code, openAi, gemini 에이전트 각각에 대해 구독중인지를 물어보고, 각 질문에 y/n으로 답을 하면 아래와 같이 설치가 완료됩니다.

(Next Steps로 각 LLM 제공자에 대한 인증을 하는 방법을 출력하는 모습을 볼 수 있습니다.)

2-3. 설치 후 LLM 제공자 인증

터미널 출력에서 지시하는 바와 같이

open code auth login

위 명령어를 입력하고 Anthropic -> Claude Pro/Max , OpenAI -> ChatGPT Plus/Pro , Google -> OAuth with Antigravity 를 각각 선택하여 본인 계정에 맞게 인증을 해줍니다.

중요 키워드: /init

/init 명령을 사용하면 OpenCode가 프로젝트 구조를 분석하고, AGENTS.md 파일을 작성합니다.

이 파일은 프로젝트에 대한 컨텍스트 정보를 담으며, AI가 더 정확한 응답을 제공하는데 도움을 줍니다.

중요 키워드: ultrawork

OpenCode의 프롬프트 창에 ultrawork 또는 ulw 를 추가하면 즉시 oh-my-opencode 의 모든 기능을 활성화할 수 있습니다.

키워드 ultrawork 또는 ulw 를 추가하면 즉시 아래 기능들이 활성화 됩니다.

• 병렬 에이전트 실행
• 백그라운드 작업 활성화
• Todo Continuation Enforcer 작동
• 전문 에이전트 자동 위임
• 완료까지 지속 실행

OpenCode Zen :: OpenCode에서 제공하는 AI Agent.

OpenCode Zen은 OpenCode 팀이 코딩 에이전트를 위해 직접 테스트하고 벤치마킹한 큐레이션 모델 게이트웨이 입니다.

코딩 작업에 효과적인 모델들만 선별하여 제공하며, 베타 기간 동안 무료로 제공 됩니다.