도구

oh-my-openagent: 멀티 모델 오케스트레이션을 Agent OS로

GitHub 68k 스타의 오픈소스 Agent 프로젝트로, 멀티 모델과 멀티 harness编排을 내세우며 유지보수자는 공개적으로 Claude Code에 반대하는 입장을 취한다. 아키텍처 3계층, 최소 설정 구성, 도입 대상을 정리한다.

글자 크기

GitHub Trending에 떠 있는 저장소: code-yeongyu/oh-my-openagent. 스타 68k, TypeScript로 작성됐고, 유지보수자는 Discord에서 commit을 실시간으로 보여준다. Building in Public 프로젝트는 흔하지만 이건 좀 다르다. 프로젝트 초석부터 Claude Code에 반기를 드는 입장이다.

저장소 소개문 원문:

So this is my lil' open source agent project, oh-my-openagent. An AI harness for tokenmaxxers, parallel multi-model + multi-harness orchestration.

tokenmaxxer를 직역하면 ‘토큰 가성비를 끝까지 끌어올리는 사람’. 매달 모델 비용으로 수백 달러 쓰면서 Kimi, GPT-5, Gemini 계정을 동시에 굴리고 있다면, 이 프로젝트가 정확히 그 용도로 만들어졌다.


무엇을解决的问题

단일 모델 Agent는 복잡한 코드베이스에서 갈수록 느려지고 비용도 올라가며, 특정 공급사에 종속된다. Claude Code는 세션 하나에 가볍게 20달러를 태우기도 하고, repo 전체를 들고 오는 긴 컨텍스트 작업에는 어쩔 수 없이 Opus 같은 비싼 모델을 써야 한다.

oh-my-openagent는 ‘Agent OS’를 표방한다. 여러 모델(Kimi, GPT-5, Gemini)과 여러 harness(OpenCode, Codex, Pi)를 직렬로 묶어编排 가능한 워크플로우로 만든다. ‘읽기’ 작업은 컨텍스트가 길고 싼 Kimi에 맡기고, ‘diff 작성’은 코드 능력이 뛰어난 GPT-5에 맡기며, ‘기획’은 Claude에 맡기는 식이다. 토큰 비용과 능력치를 기준으로 라우팅한다.

더 과감한 부분은 유지보수자의 노선이다. 이 사람은 공개 자리에서 Anthropic이 이 프로젝트 때문에 OpenCode의 특정 기능을 제한했다고 발언한 적이 있다. 사실 여부와 무관하게, ‘멀티 모델 중립 + 공급사 종속 배격’은 제품 자체에 박혀 있는 철학이다.


사용 방법

설치는 한 줄이다.

npx oh-my-opencode install

설치 후 프로젝트 루트에 agent.config.ts를 작성한다.

// oh-my-openagent Team Mode 최소 설정
import { defineConfig } from 'oh-my-opencode';

export default defineConfig({
  providers: {
    kimi:   { model: 'kimi-k3',     apiKey: process.env.KIMI_KEY },
    gpt:    { model: 'gpt-5.6-sol', apiKey: process.env.OPENAI_KEY },
    claude: { model: 'claude-sonnet', apiKey: process.env.ANTHROPIC_KEY },
  },
  mode: 'team',
  team: {
    planner:  'claude',
    readers:  ['kimi'],
    writers:  ['gpt'],
    fallback: ['claude'],
  },
  budgets: { perTaskUsd: 0.5 },
});

// 실행:
//   npx oh-my-opencode run --task "이 repo의 아키텍처를 요약해줘"

설정 블록은 네 개다. providers / mode / team / budgets.

Codex만 가볍게 붙이고 싶고 OmO 전체를 깔고 싶지 않다면, npx lazycodex-ai install 한 줄로 끝낸다. OmO의 Codex 서브셋으로, harness 레이어만 골라서 깔아준다.


동작 구조 (아키텍처)

세 계층으로 나눈다.

(1) Harness 계층: OpenCode / Codex / Pi 어댑터. tool calling 프로토콜을 통일한다. OmO는 이 계층에서 정규화를 처리하므로 상위 레이어는 하위가 무엇인지 신경 쓰지 않아도 된다.

(2) Orchestrator 계층: Team Mode는 작업을 sub-agent 단위로 쪼개고, 토큰 비용과 능력치를 기준으로 모델에 배분한다. team.readers / team.writers / team.planner가 바로 라우팅 테이블이다.

(3) Provider 계층: Anthropic, OpenAI, Mooncake, Kimi, GLM을 비즈니스 코드 수정 없이 교체한다. Provider는 provider이고 라우팅은 라우팅이다. 둘이 분리돼 있다.

저장소 루트의 ROADMAP.md에는 세 가지 대형 리팩터링이 적혀 있다. Multi-Harness Agent OS Refactor, OpenCode / Codex / Pi 지원, tool calling 프로토콜 통합. 1.0은 아직 리팩터링 중이라 API가 불안정하다.


장점과 단점

괜찮은 점:

  • 오픈소스 + 멀티 모델 중립. 스타 68k는 커뮤니티 규모를 방증한다.
  • 유지보수자가 Discord에서 개발全过程를 실시간으로 보여준다. commit message가 사람을 향해 적혀 있다.
  • 공급사 종속 배격 입장이 분명하다. Kimi, Moonshot, Mooncake 같은 비(非)미국 공급사 어댑터가 기본으로 딸려 온다.
  • Team Mode 기본 조합만으로도 바로 굴릴 수 있다.

아쉬운 점:

  • Discord 실시간 스트리밍 + 영문 문서가 기본이라, 한국·중국 등 비영어권에서 설치와 업그레이드 경험이 떨어진다.
  • 멀티 모델 조합은 본질적으로 prompt 호환성과 지연 시간을 끌어안는다. 절약한 토큰 비용의 절반이 어댑터 레이어에서 사라진다.
  • 리팩터링기라 API가 불안정하다. 지금 붙일지는 ROADMAP을 보고 판단해야 한다.
  • 유지보수 인력이 적어 장기 유지 능력에 의문이 남는다.

도입 대상

쓸 만한 경우:

  • 멀티 모델 계정을 다 갖고 있어서 단가를 더 누르고 싶은 1인 개발자
  • 대형 코드베이스에서 sub-agent를 병렬로 굴리고 싶은 5인 이하 소규모 팀
  • Claude Code 독점에 회귀하고 싶지 않고, 도구 체인을 오픈소스 중립으로 가져가고 싶은 사용자
  • ROADMAP을 직접 읽고 초기 기여에 동참할 의향이 있는 Agent 매니아

쓰지 않아도 되는 경우:

  • Claude Code 한 방으로 끝내고 싶고 여러 계정을 굴리기 귀찮은 사람
  • 지연에 민감한 운영 CI 환경 (sub-agent编排 자체가 1~3초 오버헤드를 더한다)
  • 유연성보다 안정성을 우선시하는 엔터프라이즈 사용자

정리

oh-my-openagent는 ‘또 다른 Claude Code 껍데기’가 아니다. 제품 철학은 ‘Agent는 编排 가능해야 하며, 단일 공급사에 묶이면 안 된다’다. 스타 68k는 UI가 얼마나 예뻐서가 아니라 그 입장에서 나왔다.

월 모델 비용이 이미 50만 원 넘는 사람은 ROADMAP.md를 한 번 찬찬히 읽고 나서 붙이는 편이 낫다. Anthropic 충성파는 굳이折腾할 필요가 없다.

출처: https://github.com/code-yeongyu/oh-my-openagent