OpenCode에서 Oh My ClaudeCode로…

최근 AI 코딩 도구의 선택지는 다양해졌지만, 그만큼 플랫폼 간의 정책 변화도 급격하게 일어나고 있습니다. 이 글에서는 오픈소스 에이전트인 OpenCode와 이를 확장한 Oh My OpenCode를 그리고 최근 불거진 Claude의 정책 이슈로 인해 최종적으로 Claude Code 기반의 Oh My Claude Code(oh-my-claude-sisyphus)를 선택하게 된 과정을 정리해보았습니다.

1. OpenCode: 터미널 속의 오픈소스 AI 개발자

[embed]The open source AI coding agent OpenCode - The open source coding agent.opencode.ai

OpenCode는 터미널(CLI) 환경에서 동작하는 오픈소스 AI 코딩 에이전트입니다. 기존의 Copilot이 에디터 내에서 코드 조각을 추천해 주는 수준이었다면, OpenCode는 실제 개발자처럼 터미널 명령어를 실행하고, 프로젝트 전체 파일을 읽고, 직접 수정하는 권한을 가집니다.

가장 큰 특징은 특정 AI 회사에 종속되지 않는 모델 불가지론(Model Agnostic)을 따른다는 점입니다. Claude 3.5, GPT-4o, Gemini 1.5 Pro 같은 메이저 모델부터 Ollama를 통한 로컬 LLM까지, 75개 이상의 모델 중 내 입맛에 맞는 것을 자유롭게 골라 쓸 수 있습니다.

또한 모든 처리가 Local-First로 이루어져 내 코드가 외부 클라우드에 저장될 걱정이 없으므로, 보안이 중요한 프로젝트에서도 안심하고 도입할 수 있습니다. 여기에 쉘 스크립트 실행이나 웹 검색 같은 툴 사용 권한까지 부여할 수 있어, 단순한 코드 제안을 넘어선 강력한 확장성을 경험할 수 있습니다.

2. Oh My OpenCode: ‘단일 에이전트’를 ‘전문가 팀’으로

[embed]GitHub - code-yeongyu/oh-my-opencode: The Best Agent Harness. Meet Sisyphus: The Batteries-Included… The Best Agent Harness. Meet Sisyphus: The Batteries-Included Agent that codes like you. - code-yeongyu/oh-my-opencodegithub.com

OpenCode가 ‘엔진’이라면, Oh My OpenCode는 그 엔진을 활용해 만든 ‘고성능 프레임워크’입니다. (Zsh와 Oh My Zsh의 관계와 유사합니다.)

이 도구의 핵심은 오케스트레이션(Orchestration)입니다. 하나의 AI 모델에게 모든 걸 맡기는 대신, 역할이 분담된 여러 에이전트가 협업하는 구조를 만듭니다. 이 구조는 복잡한 기능을 구현할 때 압도적인 생산성을 보여줍니다.

• 메인 오케스트레이터 (Sisyphus): 사용자의 명령을 듣고 하위 에이전트들에게 작업을 분배하고 관리하는 팀장(PM) 역할을 수행합니다.
• 전문가 에이전트 (Specialist Agents): @Oracle: 아키텍처 설계 및 심층 디버깅 담당 @Librarian: 공식 문서 탐색 및 라이브러리 리서치 담당 @Frontend: UI/UX 및 프론트엔드 코드 구현 담당…
• Ultrawork 모드: “이 기능 완성해 줘”라고 명령하면, 중간에 멈추지 않고 에러를 스스로 수정하며 완료될 때까지 작업을 반복 수행하는 기능입니다.

3. 문제 발생: Claude OAuth 정책과 계정 차단 리스크

OpenCode 생태계는 훌륭하지만, Claude 모델을 주력으로 사용하는 개발자에게는 치명적인 리스크가 발생했습니다.

최근 Reddit(링크)과 Threads(링크) 등 커뮤니티에서는 OpenCode와 같은 서드파티 툴에서 Claude Pro/Max 구독 계정을 연동해 사용하다가 계정이 영구 정지되거나 환불 처리되는 사례가 다수 보고되었습니다.

Anthropic은 타사 클라이언트가 공식 클라이언트인 척 위장하여(Spoofing: 사용자의 시스템 권한을 획득하여 정보를 탈취하는 행위) OAuth 토큰을 사용하는 것을 약관 위반으로 규정하고 강력하게 제재하기 시작했습니다. 사실상 서드파티 툴에서의 구독 계정 사용을 막고, 공식적인 과금 체계인 API Key 사용을 강제하는 방향으로 선회한 것입니다.

혹시 이 두 방식의 차이가 낯선 분들을 위해 간단히 비유하자면 다음과 같습니다.

• 구독형(OAuth) 방식: 뷔페처럼 월 정액만 내면 정해진 한도 내에서 마음껏 먹을 수 있는 방식
• API Key 방식: 회전초밥집처럼 내가 먹은 접시(사용한 토큰) 수만큼 정확하게 돈을 내는 종량제 방식

문제는 여기서 발생합니다. 코딩 에이전트는 수많은 코드를 읽고 분석하며 일반 채팅보다 압도적으로 많은 ‘접시’를 비웁니다.

API Key 방식은 정책적으로 안전하나 대량의 토큰을 소모하는 코딩 작업에서는 비용 효율이 떨어져 요금 폭탄을 맞기 십상이며, 반대로 구독형 방식은 비용은 저렴하지만 앞서 말한 정책 이슈로 인해 계정 차단 가능성이라는 치명적인 불안 요소가 존재합니다.

결국 사용자는 돈을 많이 낼 것이냐, 계정이 날아갈 위험을 감수할 것이냐 라는 진퇴양난에 빠지게 된 셈입니다. “합리적인 비용으로 고성능 에이전트를 안전하게 쓰고 싶다”는 니즈를 OpenCode 환경에서는 충족하기 어려워졌습니다.

4. Oh My ClaudeCode (v3.0): Claude Code에서 부활한 Sisyphus

[embed]GitHub - Yeachan-Heo/oh-my-claudecode: Multi-agent orchestration for Claude Code. Zero learning… Multi-agent orchestration for Claude Code. Zero learning curve. 28 agents, 28 skills, delegation-first architecture. …github.com

이러한 고민 끝에 제가 최종적으로 안착한 도구는 Anthropic의 공식 CLI인 Claude Code 위에 설치되는 플러그인, Oh My Claude Code(oh-my-claude-sisyphus)입니다.

이 도구를 선택한 가장 결정적인 이유는 독자 클라이언트가 아닌 공식 툴 내부에서 동작하는 플러그인이라는 점입니다. 덕분에 Pro/Max 구독 계정을 연동하더라도 계정 정지 걱정 없이 마음 편히 사용할 수 있습니다.

안전성을 확보했다고 해서 성능을 타협한 것도 아닙니다. Oh My OpenCode의 핵심이었던 Sisyphus 오케스트레이터와 전문가 에이전트(Oracle, Librarian 등)의 로직을 그대로 이식해 강력한 위임 기능을 유지했음은 물론, 최근 v3.0 업데이트를 통해 복잡한 명령어 없이 자연어로 요청하면 알아서 적절한 에이전트가 호출되는 압도적인 편의성까지 갖추게 되었습니다.

OpenCode는 다양한 모델을 실험하고 커스텀 하기에 가장 이상적인 도구임은 분명합니다. 하지만 Claude의 고성능 모델을 구독형 플랜으로 안전하게 사용하면서, 팀 단위의 에이전트 기능을 활용하고자 하는 저와 같은 개발자에게는 Oh My ClaudeCode가 현재로서 가장 확실하고 합리적인 대안입니다.

AI 도구의 춘추전국시대, 화려한 기능도 중요하지만 지속 가능한 개발 환경을 구축하는 것이 무엇보다 중요합니다. Claude 정책 이슈로 고민 중이신 분들께 이 글이 도움이 되기를 바랍니다!