OpenCode + oh-my-opencode 2026 완벽 가이드 — Claude Code급 무료 AI 코딩 경험 만들기

Posted on by

Claude Code 요금이 부담스럽거나, 무료로 비슷한 경험을 하고 싶은 사람들이 OpenCode 쪽을 많이 뒤진다. 근데 막상 써보면 “이게 진짜 Claude Code급이야?” 싶을 때가 있다.

Quick Answer: OpenCode 단독보다 oh-my-opencode를 같이 붙이면 훨씬 가깝다. 에이전트 모드, 파일 조작, 세션 이어받기까지 된다. 다만 Claude Code의 프로젝트 메모리, 멀티에이전트 오케스트레이션은 아직 차이가 있다. 무료로 AI 코딩 루프를 돌리고 싶다면 현실적으로 가장 가까운 선택지다.

이 글이 필요한 사람

  • Claude Code 월 비용이 부담스러워서 대안을 찾는 사람
  • OpenCode를 설치했는데 oh-my-opencode가 뭔지 모르는 사람
  • “무료 AI 코딩 도구”를 써봤는데 중간에 끊기거나 기억을 못 해서 실망한 사람
  • 개인 프로젝트나 사이드 프로젝트에 AI 코딩을 붙여보고 싶은 사람

지금 결론

  1. OpenCode 단독으로는 반쪽이다. 에디터 통합, 컨텍스트 관리, 세션 복원이 약하다.
  2. oh-my-opencode를 붙이면 달라진다. 세팅 파일 하나로 에이전트 동작 방식이 바뀐다.
  3. Claude Code와 비교하면 여전히 프로젝트 메모리와 하위 에이전트 오케스트레이션 부분에서 차이가 있다.
  4. 그래도 무료+오픈소스 조합 중 가장 쓸 만하다. 특히 개인 프로젝트나 반복 작업에서는 충분히 돌아간다.

OpenCode가 뭔지부터

OpenCode는 터미널 기반 AI 코딩 도구다. Claude Code와 유사한 방식으로 터미널에서 코드를 읽고, 수정하고, 명령을 실행한다.

특징:
– 오픈소스 (MIT 라이선스)
– 터미널 TUI 기반
– OpenAI, Anthropic, Gemini, Ollama 등 여러 제공자 연결 가능
– 파일 읽기/쓰기/실행 지원

2026년 현재 기준으로 꽤 활발하게 업데이트 중이다. 단순 Q&A 모드를 넘어서 에이전트형 작업도 할 수 있다.

oh-my-opencode가 뭔지

oh-my-opencode는 OpenCode를 위한 커뮤니티 설정 레이어다. oh-my-zsh가 zsh를 감싸는 것처럼, OpenCode의 기본 동작을 확장해주는 설정 묶음이다.

핵심 기능:
– AGENTS.md 기반 에이전트 역할 분리
– 프로젝트 규칙 파일 (CLAUDE.md 대신 자체 포맷)
– 세션 저장/복원 개선
– 커스텀 툴 정의 확장
– 테마 및 단축키 세팅

즉 OpenCode의 “날 것 상태”를 팀 운영 수준으로 끌어올려주는 레이어다.

설치 방법 (2026년 3월 기준)

Step 1. OpenCode 설치

npm install -g opencode
# 또는
brew install opencode

설치 후 확인:

opencode --version

Step 2. oh-my-opencode 설치

git clone <https://github.com/oh-my-opencode/oh-my-opencode> ~/.opencode/oh-my-opencode
cd ~/.opencode/oh-my-opencode && ./install.sh

설치 후 ~/.opencode/config.json이 자동으로 생성된다.

Step 3. 모델 연결

~/.opencode/config.json에서 기본 모델을 설정한다.

무료로 쓸 때 현실적인 선택지:
– Ollama (로컬): 완전 무료, GPU 사양 필요
– Gemini Flash 2.0 (API): 무료 티어 존재, 속도 빠름
– GPT-4o-mini: 저비용, 코딩 작업에 충분

{
  "provider": "gemini",
  "model": "gemini-2.0-flash",
  "api_key": "YOUR_GEMINI_API_KEY"
}

oh-my-opencode 핵심 세팅 3가지

Claude Code급으로 쓰려면 이 3개는 꼭 설정해야 한다.

1. AGENTS.md 설정

프로젝트 루트에 AGENTS.md 파일을 만든다. 각 에이전트의 역할과 제약을 정의한다.

# Project Agents

## researcher
파일을 읽고 컨텍스트를 수집한다. 수정은 하지 않는다.

## writer
researcher가 넘긴 컨텍스트 기반으로 코드를 작성한다.

## reviewer
작성된 코드를 검증한다. 통과/실패를 명확히 판정한다.

2. 세션 저장 설정

oh-my-opencode는 기본적으로 세션을 .opencode/sessions/ 에 저장한다.

config.json에 추가:

{
  "session": {
    "auto_save": true,
    "save_interval": 300,
    "max_sessions": 10
  }
}

이렇게 하면 중간에 끊겨도 opencode --resume 으로 이어받을 수 있다.

3. 프로젝트 규칙 파일

프로젝트 루트에 .opencode/RULES.md 를 만든다.

# Project Rules

- 파일 수정 전 반드시 읽어라
- 절대 경로만 사용하라
- 테스트 없는 코드는 작성하지 마라
- 완료 기준을 먼저 명시하라

이게 있으면 매번 프롬프트에 규칙을 써넣지 않아도 된다.

Claude Code와 실제로 뭐가 다른가

솔직하게 비교하면 이렇다.

비슷한 것

  • 터미널 기반 파일 읽기/수정
  • 에이전트 역할 분리 (AGENTS.md)
  • 도구 호출 (파일, 셸, 웹검색)
  • 반복 작업 자동화

아직 차이 나는 것

항목 Claude Code OpenCode + oh-my-opencode
프로젝트 메모리 세션 간 지속 세션별 리셋 (저장 가능하지만 수동)
멀티에이전트 병렬 실행 Task 도구로 네이티브 지원 시퀀셜 위주
하네스/상태 저장 state.json 네이티브 커스텀 구현 필요
모델 품질 (기본값) Claude Sonnet 4.6 설정에 따라 다름
비용 유료 (사용량 기반) 무료~저비용 가능

정리하면: 단일 에이전트 반복 작업은 충분히 가능하다. 팀 오케스트레이션이나 장기 메모리가 필요하면 차이가 크다.

실전에서 잘 되는 작업 vs 기대 이하인 작업

잘 되는 것

  • 파일 여러 개 읽고 요약/비교
  • 코드 패턴 변환 (리팩토링)
  • 반복 스크립트 작성/실행
  • 블로그 초안처럼 구조가 정해진 글쓰기
  • 설정 파일 수정

기대 이하인 것

  • 세션 간 컨텍스트 이어받기 (수동으로 설정해야 함)
  • 복잡한 멀티에이전트 협업
  • 오류 발생 시 자동 복구 (사람이 개입해야 함)
  • 대형 코드베이스 전체 분석

팀 운영에 쓰는 법

개인 프로젝트 수준을 넘어서 팀처럼 쓰고 싶다면 이 구조를 참고한다.

.opencode/
├── config.json       ← 모델·세션 설정
├── RULES.md          ← 프로젝트 전역 규칙
└── sessions/         ← 세션 저장소

AGENTS.md             ← 에이전트 역할 정의

터미널 두 개를 열고:
– 터미널 1: opencode --agent researcher (읽기/조사 전담)
– 터미널 2: opencode --agent writer (작성 전담)

tmux로 묶으면 ClawTeam 방식과 유사하게 운영할 수 있다.

실수 TOP 4

1. oh-my-opencode 없이 OpenCode만 설치하는 실수

OpenCode 단독으로는 세션 관리, 에이전트 분리, 규칙 적용이 약하다. 반드시 함께 설치해야 한다.

2. AGENTS.md 없이 쓰는 실수

역할 정의가 없으면 모든 작업을 한 에이전트가 다 하게 되고, 결과가 일관성 없어진다.

3. 세션 저장 설정 안 하는 실수

중간에 연결 끊기면 컨텍스트가 날아간다. auto_save: true 설정은 처음에 반드시 한다.

4. Claude Code와 동일하게 기대하는 실수

프로젝트 메모리나 병렬 에이전트 부분은 현재 Claude Code보다 약하다. 이 차이를 모르고 쓰면 실망하기 쉽다.

FAQ

Q. OpenCode는 완전 무료인가요?

오픈소스 자체는 무료다. 다만 연결하는 AI 모델은 유료일 수 있다. Ollama 로컬 모델이나 Gemini 무료 티어를 쓰면 실질 비용 없이 돌릴 수 있다.

Q. oh-my-opencode는 공식 플러그인인가요?

아니다. 커뮤니티 기반 프로젝트다. OpenCode 공식 팀과는 별개로 운영되며, 독립적으로 업데이트된다.

Q. Claude Code 대비 코딩 품질은 어떤가요?

모델 선택에 따라 다르다. Claude Sonnet 급 모델을 붙이면 비슷한 품질이 나온다. 무료 모델(Gemini Flash, Llama 등)은 빠르지만 복잡한 작업에서 오류율이 높다.

Q. Windows에서도 되나요?

OpenCode는 Node.js 기반이라 Windows에서도 동작한다. 다만 oh-my-opencode의 일부 셸 스크립트는 WSL 환경이 필요할 수 있다.

Q. 기업 환경에서 써도 되나요?

코드가 외부 AI 서버로 전송된다는 점에서 보안 정책 확인이 필요하다. Ollama 로컬 모델 조합이면 네트워크 격리 환경에서도 쓸 수 있다.

다음에 읽을 글

결론

OpenCode + oh-my-opencode 조합은 2026년 기준 무료 AI 코딩 도구 중 가장 Claude Code에 가깝다. 설치는 30분이면 되고, AGENTS.md와 RULES.md만 잘 잡으면 개인 프로젝트에서 충분히 굴릴 수 있다.

다만 프로젝트 메모리, 병렬 에이전트, 장기 컨텍스트 유지가 중요한 작업이라면 Claude Code와의 차이를 체감하게 된다. 그 차이를 알고 쓰는 게 핵심이다.

참고 자료

SNS 포스트 (복사용)

X (280자)

OpenCode + oh-my-opencode 2026년 기준으로 진짜 써봤다. AGENTS.md + 세션저장 + 규칙파일 세팅을 붙이면 Claude Code와 생각보다 가까운 경험이 된다. 무료~저비용으로 AI 코딩 루프 돌리고 싶다면 현실적으로 제일 가까운 선택지다.

스레드 (500자)

Claude Code 비용이 부담스러워서 OpenCode를 써봤는데, 단독으로는 세션 관리랑 에이전트 역할 분리가 약했다.

oh-my-opencode를 함께 붙이니까 달라졌다.

핵심 차이는 3개다.
– AGENTS.md로 역할 분리
– 세션 자동저장으로 중간 끊김 대응
– RULES.md로 반복 지시 제거

Claude Code 대비 프로젝트 메모리와 병렬 에이전트는 여전히 차이가 있다. 하지만 개인 프로젝트나 반복 작업 자동화에는 충분히 쓸 만하다. 설치부터 팀 운영 구조까지 정리했다.