완벽 가이드

Oh My OpenCode

코딩 몰라도 내 서비스 만든다.
AI 개발팀을 5분 만에 꾸리는 방법.

설치부터 실전까지, 이 가이드 하나면 끝. 터미널 처음이어도 괜찮아요.

OpenCode 60K+ Stars · OmO 36.5K Stars · 75+ 모델 지원

설치부터 시작 → 3시간이면 내 서비스 URL →

✓ 터미널 처음이어도 OK · ✓ 카드 결제 없음 (오픈소스) · ✓ 막히면 캠프에서 5분 해결

OpenCode와 Oh My OpenCode,
뭐가 달라요?

10초면 이해됩니다.

🚗

OpenCode = 차 (필수)

AI가 코드를 짜는 '본체'. 오픈소스 터미널 도구.
Claude, GPT, Gemini 등 75+ 모델 지원.

⚡

OmO = 프리미엄 업그레이드 (추천)

OpenCode 위에 얹는 '플러그인'. AI 1명을 역할분담된 6명의 팀으로.

차(OpenCode) 먼저 설치 → 그 다음 업그레이드(OmO) 설치

설치 순서: 1) OpenCode → 2) Bun → 3) PATH 설정 → 4) OmO → 5) 모델 연결

여기까지 읽었으면 이미 상위 10%.
대부분은 '터미널'이라는 단어에서 도망칩니다.

5분이면 설치 끝

💡 복붙만 하면 됩니다

코드를 이해할 필요 없습니다. 명령어를 복사 → 붙여넣기 → 엔터. 끝.

터미널 열기

Cmd(⌘) + Space → "터미널" 입력 → Enter
검은 화면이 뜨면 성공

Windows 키 → "PowerShell" 검색 → Enter
파란 화면이 뜨면 성공

OpenCode 설치

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

먼저 스크립트 실행을 허용합니다 (최초 1회):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

패키지 관리자 Scoop을 설치합니다:

irm get.scoop.sh | iex

OpenCode를 설치합니다:

scoop install opencode

설치 후 터미널을 껐다가 다시 열고 확인:

opencode --version

✅ 버전 번호가 나오면 성공

벌써 절반 왔어요. 나머지도 복붙이면 끝.

Bun 설치

OmO를 실행하는 데 필요한 도구입니다.

curl -fsSL https://bun.sh/install | bash

설치 후 터미널을 완전히 닫고 다시 열기 (새 탭 아님 — 빨간 × 눌러서 종료 후 재시작)

scoop install bun

설치 후 PowerShell 껐다 다시 열기

bun --version

✅ 버전 번호가 나오면 성공

PATH 설정 (Mac만 해당)

💡 왜 이게 필요한가요?

Mac에서 새로 설치한 프로그램은 "어디 있는지" 터미널에게 알려줘야 합니다. 이걸 PATH 설정이라고 해요.

아래 명령어를 한 줄씩 실행하세요:

echo 'export PATH="$HOME/.opencode/bin:$HOME/.bun/bin:$PATH"' >> ~/.zprofile

source ~/.zprofile

설정이 됐는지 확인:

opencode --version

bun --version

✅ 둘 다 버전 번호가 나오면 성공. command not found가 나오면 터미널을 완전히 닫고 다시 열어보세요.

💡 Windows는 이 단계가 필요 없습니다

Scoop으로 설치하면 PATH가 자동 설정됩니다. 바로 다음 단계로 넘어가세요.

Oh My OpenCode(OmO) 설치

bunx oh-my-opencode install

⚠️ Windows: 관리자 권한 필요

PowerShell을 관리자 권한으로 다시 여세요. (시작 → PowerShell 우클릭 → "관리자 권한으로 실행")

cd ~

bunx oh-my-opencode install

✅ "Installation complete!" 메시지가 나오면 완료

AI 모델 연결하기

설치가 끝났으면 OpenCode를 실행하세요. 처음 실행하면 온보딩이 자동으로 시작되고, 원하는 모델을 선택할 수 있습니다.

mkdir my-project && cd my-project && opencode

OpenCode TUI(터미널 화면)가 열리면 온보딩 화면이 나옵니다. 원하는 AI 모델을 선택하세요.

방법 1: 구독 연결 (정액제) — 추천

이미 ChatGPT Plus, Claude Pro/Max 등을 구독 중이라면, 별도 API Key 없이 기존 구독으로 바로 연결할 수 있습니다.

온보딩에서 "ChatGPT Plus/Pro" 또는 "Claude Pro/Max" 선택 → 브라우저에서 로그인 → 자동 연결.

서비스	구독 플랜	월 비용	추천도
Claude Max	Anthropic 구독	$100~$200/월	필수
ChatGPT Plus/Pro	OpenAI 구독	$20+/월	필수
Gemini	Google	무료 티어 있음	추천
GitHub Copilot	Copilot Pro+	$10~$39/월	선택

⚠️ 일부 모델 제공사의 정책 안내

몇몇 모델 제공사(예: Anthropic, OpenAI)는 개인 구독을 이런 방식으로 연결하는 것을 공식적으로 권장하지 않을 수 있습니다. 현재는 작동하지만, 제공사 정책 변경에 따라 달라질 수 있다는 점을 참고하세요.

방법 2: API Key (종량제)

AI 제공자의 개발자 콘솔에서 키를 발급받아 연결합니다. 쓴 만큼 과금되며, 모델과 사용량에 따라 비용이 크게 달라집니다.

온보딩에서 Provider 선택 → API Key 붙여넣기 → 완료.

⚠️ API Key 비용 주의

API Key는 사용한 만큼 과금됩니다. AI 코딩 에이전트는 토큰 사용량이 많아서, 한 번 작업에 수천 원~수만 원이 나올 수 있습니다. 반드시 사용량 한도(Spending Limit)를 설정하세요.

OpenAI API Key 발급하기

platform.openai.com/api-keys 접속
"Create new secret key" 클릭 → 키 복사
OpenCode 온보딩에서 OpenAI 선택 → 키 붙여넣기

Anthropic API Key 발급하기

console.anthropic.com 접속
"Create Key" 클릭 → 키 복사
OpenCode 온보딩에서 Anthropic 선택 → 키 붙여넣기

API Key vs 구독, 뭐가 다른가요?

항목	구독 (정액제)	API Key (종량제)
결제	월 정액	쓴 만큼 과금
비용 예측	쉬움 (매달 같은 금액)	어려움 (사용량에 따라 변동)
비용 리스크	없음 (정액)	주의 필요 (한도 미설정 시 고액 청구 가능)
사용 제한	시간/일 쿼터 있음	잔액 내 무제한
모델 선택	구독 서비스 모델만	75+ 모델 자유 선택
추천 상황	이미 구독 중이라면 가장 간편	다양한 모델 필요, 비용 관리 가능한 사람

💡 뭘 선택할지 모르겠다면?

이미 ChatGPT Plus나 Claude Max를 쓰고 있다면 → 구독 연결이 가장 빠르고 안전합니다.
처음이고 구독이 없다면 → 구독부터 시작하는 걸 추천합니다. API Key는 비용 관리가 어렵습니다.

⚠️ API 키 = 비밀번호

절대 다른 사람에게 공유하거나 인터넷에 올리지 마세요.

✅ OpenCode에서 "안녕?"이라고 입력했을 때 AI가 응답하면 연결 성공!

여기까지 했으면 이미 상위 10%.

대부분은 '터미널'이라는 단어에서 도망칩니다.

혼자 막히면 Camp에서 5분 해결 →

설치하다 막혔나요? 정상이에요.

혼자 30분 헤매기 vs 멘토 5분 해결

Camp에서 같이 설치하기 →

이렇게 쓰면 됩니다

OmO를 설치하면 쓸 수 있는 강력한 워크플로우들입니다.

ultrawork — 병렬 자율 실행

"이거 해줘" 한 마디면 끝. AI가 설계부터 구현까지 동시에 처리해요.

plan → /start-work — 계획 후 실행

실수 방지. AI가 먼저 계획을 보여주고, 확인하면 실행해요. 큰 프로젝트에서 특히 유용.

/ralph-loop — 끝까지 자동 완성

에러나도 걱정 NO. 스스로 고쳐가며 끝까지 완성해요. 자리 비워도 OK.

team — 다중 에이전트 협업

여러 AI가 하나의 작업 목록을 나눠서 동시에 처리. 대규모 프로젝트에 적합해요.

기능별 사용 예시

ultrawork 예시:

ultrawork 블로그 서비스를 만들어줘. 마크다운 에디터, 글 목록, 태그 필터링 포함.

plan 예시:

plan 기존 Todo 앱에 팀 기능을 추가하고 싶어. 초대, 권한 관리 포함.

계획이 나오면 확인 후 /start-work으로 실행합니다.

/ralph-loop 예시:

/ralph-loop 이 프로젝트의 모든 테스트가 통과하도록 코드를 수정해줘.

에이전트 팀

OmO는 혼자 일하는 AI를 역할이 나뉜 6명의 팀으로 만듭니다.
각 에이전트는 자기 역할에 최적화된 모델과 프롬프트를 사용합니다.

Sisyphus

총괄 오케스트레이터. 작업을 분배하고 전체 흐름을 관리.

Hephaestus

실제 코드 작성/수정. 가장 많이 일하는 에이전트.

Prometheus

계획 수립과 설계. plan의 핵심 두뇌.

Oracle

아키텍처 자문과 코드 리뷰. 어려운 결정을 도움.

Librarian

문서, 레퍼런스, 외부 자료 검색 전문.

Explore

코드베이스 탐색. 기존 코드 패턴을 찾아줌.

💡 에이전트를 직접 부를 필요는 없습니다

OmO가 작업에 따라 자동으로 적절한 에이전트를 배치합니다. ultrawork이나 plan 같은 키워드만 입력하면 됩니다.

실전 챌린지: 1시간 안에 앱 만들기

설치와 모델 연결이 끝났다면, 아래 프롬프트를 그대로 복붙해서 로그인 + DB가 있는 앱을 만들어보세요.

복붙 프롬프트

ultrawork 로그인과 회원가입이 있는 Todo 앱을 만들어줘.
- 이메일+비밀번호로 로그인/회원가입
- SQLite DB에 사용자와 Todo 데이터 저장
- Todo CRUD (추가, 조회, 수정, 삭제)
- 로컬에서 바로 실행할 수 있게 해줘
- 완성되면 실행 명령어를 알려줘
- 에러가 나면 자동으로 고쳐줘

AI가 자동으로 파일을 만들고, 코드를 짜고, 에러를 고칩니다. 5~30분 정도 기다리면 앱이 완성됩니다.

완성되면 AI가 알려주는 실행 명령어를 입력하세요 (보통 npm start 또는 bun run dev).

🎉 성공: 브라우저에서 localhost:3000에 접속 → 로그인 화면이 뜨고, 회원가입 후 Todo 추가/삭제가 되면 완성!

선택: 인터넷에 배포하기

로컬에서 잘 되면, 인터넷에 공개할 수도 있습니다:

이 앱을 Vercel이나 Railway에 배포해줘. 무료 플랜으로.

다른 챌린지 아이디어

블로그: ultrawork 마크다운 블로그를 만들어줘. 글 작성/수정/삭제, 태그 필터링 포함.
채팅앱: ultrawork 실시간 채팅앱을 만들어줘. 닉네임 설정, 채팅방 입장/퇴장.
포트폴리오: ultrawork 개인 포트폴리오 사이트를 만들어줘. 프로젝트 갤러리, 연락처 폼.

지금부터는 참고용이에요. 필요할 때 돌아오면 됩니다.

안 될 때 보는 곳

에러가 나면 메시지를 그대로 복사해서 아래에서 찾아보세요.

command not found

증상: 명령어 입력 시 "command not found"

해결: 터미널을 완전히 닫고 새로 열기. 그래도 안 되면 컴퓨터 재시작.

permission denied

Mac: 명령어 앞에 sudo 붙이기

Windows: PowerShell을 "관리자 권한으로 실행"

API 키/모델이 응답하지 않을 때

API 키에 크레딧(잔액) 확인 — 무료 체험 만료 가능
키 복사 시 앞뒤 공백 확인
opencode auth login으로 Provider 재인증 시도
구독 연결의 경우 쿼터 초과 여부 확인

Windows 스크립트 실행 차단

PowerShell에서:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

설치가 중간에 멈출 때

Ctrl + C로 중단 → 인터넷 확인 → 처음부터 다시.

🆘 위에 없는 에러?

터미널 화면을 캡처해서 ChatGPT/Claude에게 물어보세요. AI가 바로 알려줍니다.

자주 쓰는 명령어 모음

명령어	설명
키워드 (채팅에 그냥 입력)
`ultrawork [요청]`	병렬 자율 실행 (가장 강력)
`plan [요청]`	계획 먼저, 실행은 나중에
`team [요청]`	다중 에이전트 협업
슬래시 명령어
`/start-work`	plan으로 만든 계획 실행
`/ralph-loop [요청]`	끝까지 자동 완성 실행
`/ulw-loop [요청]`	ultrawork 연속 실행 모드
`/help`	전체 명령어 보기
터미널 명령어 (OpenCode TUI 밖에서)
`opencode auth login`	모델/키 연결

용어 사전

터미널 (Terminal): 텍스트로 컴퓨터에게 명령을 내리는 창. Mac은 "터미널", Windows는 "PowerShell".
TUI (Terminal User Interface): 터미널 안에서 동작하는 UI. OpenCode를 실행하면 보이는 화면.
API 키 (API Key): AI 서비스에 접속하기 위한 비밀번호. 외부에 공유 금지.
모델 (Model): AI의 두뇌. GPT-4o, Claude Sonnet, Gemini 등이 모두 '모델'.
에이전트 (Agent): 스스로 판단하고 행동하는 AI. OpenCode는 에이전트형 AI 코딩 도구.
프롬프트 (Prompt): AI에게 주는 지시. "~을 만들어줘" 같은 문장.
토큰 (Token): AI가 처리하는 텍스트의 단위. API Key 방식에서 토큰 수에 따라 과금.

AI로 내 서비스, 3시간이면 충분합니다

실습 끝나면 접속 가능한 URL을 드려요.
멘토가 옆에서 하나하나 같이 만듭니다.

OpenCode Camp 알아보기 →

Oh My OpenCode

OpenCode와 Oh My OpenCode,뭐가 달라요?

5분이면 설치 끝

터미널 열기

OpenCode 설치

Bun 설치

PATH 설정 (Mac만 해당)

Oh My OpenCode(OmO) 설치

AI 모델 연결하기

추천 모델 조합

방법 1: 구독 연결 (정액제) — 추천

방법 2: API Key (종량제)

API Key vs 구독, 뭐가 다른가요?

이렇게 쓰면 됩니다

에이전트 팀

실전 챌린지: 1시간 안에 앱 만들기

안 될 때 보는 곳

자주 쓰는 명령어 모음

AI로 내 서비스, 3시간이면 충분합니다

OpenCode와 Oh My OpenCode,
뭐가 달라요?