컨텐츠로 건너뛰기

빠른 시작

빠른 시작

5분 안에 Oh My OpenAgent를 실행하세요. 두 가지 설치 방법 — 에이전트에게 맡기거나 직접 설치하세요.

사전 요구 사항

  • OpenCode가 설치 및 구성되어 있어야 합니다
  • 최소 하나의 LLM 구독과 API 액세스 (Claude, ChatGPT, Kimi, GLM 등)

설치

방법 A: 에이전트 지원 설치 (권장)

다음 프롬프트를 복사하여 LLM 에이전트(Claude Code, AmpCode, Cursor 등)에 붙여넣으세요:

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

에이전트가 다음을 수행합니다:

  • oh-my-opencode 패키지를 다운로드 및 설치
  • opencode.json에 플러그인을 등록
  • 기본 설정 구성

방법 B: 수동 설치

설치 가이드를 단계별로 따라하세요.

첫 실행: ultrawork

설치 후 바로 ultrawork를 사용해 보세요:

ultrawork

또는 더 짧은 별칭:

ulw

단 한 단어로 모든 에이전트가 활성화됩니다. 작업이 완료될 때까지 멈추지 않습니다.

추천 구독

Oh My OpenAgent는 다음 구독과 잘 작동합니다 (제휴 없음, 개인 추천):

구독가격비고
ChatGPT$20/월견고한 멀티 에이전트 경험
Kimi Code$0.99/월뛰어난 가성비, 한정된 기간 가격
GLM Coding Plan$10/월GLM 모델 액세스에 적합

토큰당 결제 액세스가 있는 경우 Kimi와 Gemini 모델은 매우 저렴합니다.

설치 확인

내장된 doctor 명령어를 실행하세요:

bunx oh-my-opencode doctor

다음 사항을 확인합니다:

  • opencode.json의 플러그인 등록
  • 설정 파일 유효성
  • 모데 가용성 및 API 키
  • 환경 설정

컨텍스트 주입

Oh My OpenAgent는 모든 세션에 컨텍스트를 자동으로 주입합니다:

  • AGENTS.md — 계층적 프로젝트 컨텍스트 (/init-deep 참조)
  • README.md — 프로젝트 개요
  • 조건부 규칙 — 파일 유형, 에이전트, 작업 단계에 따라 자동 활성화

원격 측정

PostHog를 통한 익명 원격 측정이 기본적으로 활성화되어 있습니다. 원시 호스트명이 아닌 해시된 설치 식별자를 사용합니다.

비활성화하려면:

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 또는
export OMO_DISABLE_POSTHOG=1

자세한 내용은 개인정보 보호정책을 참조하세요.

제거

Oh My OpenAgent를 제거하려면:

  1. 플러그인 항목 제거 opencode.json에서:
# jq 사용
jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
  ~/.config/opencode/opencode.json > /tmp/oc.json && \
  mv /tmp/oc.json ~/.config/opencode/opencode.json
  1. 설정 파일 제거 (선택 사항):
rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
  ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
  .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
  1. 제거 확인: opencode --version — 플러그인이 더 이상 나타나지 않아야 합니다.

다음 단계