완벽 가이드

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 키에 크레딧(잔액) 확인 — 무료 체험 만료 가능
키 복사 시 앞뒤 공백 확인
/connect로 Provider가 맞는지 확인
구독 연결의 경우 쿼터 초과 여부 확인

Windows 스크립트 실행 차단

PowerShell에서:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

설치가 중간에 멈출 때

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

🆘 위에 없는 에러?

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

자주 쓰는 명령어 모음

명령어	설명
`/ultrawork [요청]`	병렬 자율 실행 (가장 강력)
`/plan [요청]`	계획 먼저, 실행은 나중에
`/start-work`	/plan으로 만든 계획 실행
`/ralph-loop [요청]`	끝까지 자동 완성 실행
`/team [요청]`	다중 에이전트 협업
`/connect`	모델/키 연결
`/config`	설정 변경
`/help`	전체 명령어 보기

용어 사전

터미널 (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,
뭐가 달라요?