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 충성파는 굳이折腾할 필요가 없다.