OpenCode는 터미널 환경에서 실행되는 오픈소스 AI 코딩 CLI 도구입니다. IDE 플러그인 중심이 아닌 쉘 기반 구조로 설계되어, 개발자의 기존 작업 흐름을 끊지 않고 코드 작성과 수정, 분석을 이어갈 수 있도록 돕습니다.

OpenAI, Gemini, Claude 등 다양한 AI 모델을 하나의 환경에서 연동할 수 있어, 작업 목적과 스타일에 맞게 모델을 선택하고 조합하는 멀티 모델 구조를 구현할 수 있습니다.

이 글에서는 OpenCode가 어떤 방식으로 동작하는지, 기존 AI 코딩 도구와 무엇이 다른지, 그리고 실제 개발 환경에서 어떻게 활용할 수 있는지를 정리해보겠습니다.

오픈코드(Opencode)란?

OpenCode는 터미널 환경에서 사용하는 오픈소스 AI 코딩 CLI 도구입니다. 쉘에서 직접 실행하는 방식으로 설계된 AI 기반 CLI 도구로, 개발 흐름을 끊지 않는 환경을 제공합니다.

AI CLI 모델 답게 자연어만 입력해도 코드를 생성하고 수정할 수 있습니다. 코드 작성, 리팩토링, 설명, 디버깅 보조를 하나의 흐름 안에서 처리할 수 있습니다. 

하나의 OpenCode 환경에서 여러 AI 모델을 연결해 사용할 수 있어, 작업 목적과 스타일에 맞게 유연하게 활용할 수 있습니다.

오픈코드(OpenCode)가 주목받는 이유 -

AI CLI의 사용 방식을 바꾼 Oh-My-OpenCode

* 이미지 출처: GeekNews 커뮤니티

Oh-My-OpenCode는 OpenCode 위에서 동작하는 커뮤니티 기반 확장 프로젝트로, 사용자 경험과 작업 흐름을 크게 확장한 사례로 주목받고 있습니다.

한국인 개발자가 만든 이 프로젝트는, 단순한 기능 추가를 넘어 OpenCode의 사용 방식을 완전히 다르게 보여주었습니다.

제작자는 약 $24,000 상당의 토큰을 사용해 다양한 LLM을 장기간 테스트하며, Claude, Gemini, ChatGPT, Grok 등 여러 모델을 상황에 맞게 오케스트레이션하는 구조를 실험적으로 검증해 왔다고 밝히고 있습니다.

또한 AST-GREP과 LSP 등을 활용해 코드를 분석하고 리팩토링하며, AI 특유의 과도한 주석이나 불필요한 변경을 최소화하는 방향으로 설계했다고 설명합니다.

이러한 경험을 바탕으로, 작업 유형에 따라 모델과 역할을 분리해 실행할 수 있는 구조를 구현했으며, 이 점에서 Oh-My-OpenCode는 기존 AI 코딩 도구와는 다른 접근을 보여줍니다.

OhMyOpenCode는 

어떤 특징이 있을까?

1. 실사용 경험 기반으로 설계된 구조

Oh-My-OpenCode는 실제 사용 경험과 반복 실험을 통해 만들어졌습니다. 제작자는 다양한 LLM을 직접 사용하며, 각각의 특성과 한계를 비교·검증해 왔다고 설명합니다. 이 과정에서 얻은 인사이트를 구조에 반영한 것이 특징입니다.

2. 에이전트 팀처럼 동작하는 구조

Oh-My-OpenCode는 설계, 구현, 검증, 정리처럼 역할을 나눈 여러 에이전트를 동시에 운용하는 구조를 지향합니다. 이 방식은 ‘멀티 에이전트’로 OpenCode를 실제 개발 팀의 협업 구조와 유사하게 활용할 수 있게 합니다.

3. 병렬 처리와 자동화 흐름

Oh-My-OpenCode는 OpenCode 기본 구조보다 더 자동화되고 병렬적인 흐름을 만듭니다. 여러 작업을 동시에 처리하도록 구성할 수 있습니다. 

이로 인해 복잡한 작업을 분해해 효율적으로 처리할 수 있습니다. 단순한 AI 도우미가 아니라, 작업 시스템에 가깝다는 평가를 받는 이유입니다.

오픈코드(OpenCode) 사용법

* Window 사용자 설치 방법

방법 1) Scoop으로 설치

Windows에서 CLI 도구를 가장 깔끔하게 관리하고 싶은 사람에게 추천드립니다.

* PowerShell에서:

* Scoop이 없다면 먼저 설치:

방법 2) Chocolatey로 설치

Windows에서 여러 프로그램을 한 번에 관리하는 사람에게 추천드립니다.

* choco가 없다면 설치부터 필요합니다.

방법 3) npm으로 설치

Node.js를 이미 쓰고 있는 개발자에게 추천드립니다.

* macOS / Linux 사용자 설치 방법

Homebrew로 설치

Homebrew를 사용 중이라면 다음 명령어를 사용하세요.

OpenCode 실행

opencode를 입력해 OpenCode를시작합니다.

모드 설정

OpenCode는 작업 방식에 따라 활용할 수 있는 Plan과 Build 두가지 모드를 제공합니다.

• Build 모드 — 계획 없이 바로 작업 실행

Build 모드는 별도의 사전 설계 없이, 바로 코드 작업을 시작하는 방식입니다.

빠르게 프로토타입을 만들거나, 간단한 기능을 추가할 때 적합합니다.

• Plan 모드 — 구조 분석 후 계획을 세우고 개발

Plan 모드는 먼저 프로젝트 구조를 분석하고,그에 맞는 개발 계획을 수립한 뒤 작업을 진행하는 방식입니다.

LLM 제공자 연결

OpenCode가 실행 후 /Connect(Connect a provider)를 입력하면 Provider에서 제공하는 방법으로 LLM 제공자를 선택할 수 있습니다. 

OpenCode Zen을 선택하면 https://opencode.ai/zen에서 API를 발급받을 수 있습니다.

나머지 모델들 중 구독한 계정이 있다면 선택 후 로그인할 수 있습니다.

로그인을 원하는 모델을 클릭하면 Provider에서 제공하는 인증 주소가 나옵니다. 클릭하면 로그인 주소로 연결됩니다.

계정을 연결하면, OpenCode에서 연동되어 사용할 수 있습니다.

사용할 수 있는 모델 리스트를 확인하는 /Models 명령어를 입력하면 연동된 계정이 추가된 것을 볼 수 있습니다.

오픈코드(OpenCode) 

- OhMyOpenCode 설치 방법

OpenCode에서 모델을 바꿔 작업을 진행하게 될 경우 일일이 모델을 다시 입력해야하는 번거로움이 있는데요. 

OhMyOpenCode는 서브 에이전시를 제공해 원하는 모델의 서브 에이전트를 여러 개 띄워 작업할 수 있습니다. 덕분에  Model을 일일이 변경하는 번거로움 없이 빠르게 작업이 가능해졌습니다.

* 이미지 출처: OhMyOpenCode Github 홈페이지

서브 에이전시를 제공하는 OhMyOpenCode를 사용하기 위해서는 먼저 OpenCode의 Github 주소로 들어가야합니다. 

Installation - For Human에 나와있는 코드 주소를 복사합니다.

OhMyOpenCode에 복사한 주소를 입력하면 자동으로 설치가 됩니다.

하단 창에는 Claude, ChatGPT, Gemini 등 LLM 제공자의 연결 상태가 표시됩니다. 

하나의 모델만 선택하면 해당 모델 기반으로 서브 에이전트가 동작하고, 여러 모델을 선택하면 역할별로 나누어 활용할 수 있습니다. 필요에 따라 원하는 모델을 활성화해 연동하면 됩니다.

모델 사용 여부는 Confirm에서 확인할 수 있습니다. 확인한 뒤 Enter를 누르면 설치를 진행합니다.

선택된 모델들로 설치가 진행되는 것을 확인할 수 있습니다. OpenCode에서 OpenCode Zen, GPT-5.3, Gemini를 사용하려면 각각 API 로그인이 필요합니다.

위 화면은 GPT 화면이므로, 터미널을 다시 실행한 뒤 로그인 명령어를 입력해야 합니다. 터미널을 재실행하고 opencode auth login를 입력합니다.

OpenCode 내에서 AI 모델 로그인 하는 방법

로그인이 필요한 모델을 선택한 뒤 로그인 방식을 선택합니다. 각 모델은 기존 계정(OAuth)으로도 로그인할 수 있지만, OpenCode의 멀티 에이전트 기능을 안정적으로 활용하려면 API 방식 로그인을 권장합니다.

▶ Gemini API 발급 방법 보러가기

▶ OpenAI의 API 발급 방법 보러가기

선택한 모델의 API 연동이 완료되었는지는 opencode auth list를 입력하면 확인할 수 있습니다.

OhMyOpenCode Agent 프리셋 설정하기

OhMyOpenCode를 설치하면 OpenCode의 모드가 추가됩니다. Build와 Plan 2가지에서 Sisyphus, Hephaestus, Prometheus, Atlas 4가지로 변동됩니다. 각각 그리스 신화에서 이름을 따왔으며, 역할도 이름의 의미와 맞닿아 있습니다.

Sisyphus(Ultraworker)

메인 오케스트레이터 역할을 합니다. 작업을 분석하고 전문 에이전트에게 위임하며, 완료될 때까지 멈추지 않고 실행하는 것이 특징입니다. 

대부분의 작업은 Sisyphus에서 시작하며, ulw 또는 ultrawork 명령어로 풀파워 모드를 활성화할 수 있습니다. 

Hephaestus(Deep Agent)

GPT-5.3 Codex 기반의 자율 실행 에이전트입니다. 목표만 주면 코드베이스를 스스로 탐색하고, 패턴을 파악해 처음부터 끝까지 실행합니다. 

복잡한 아키텍처 분석, 멀티 파일 디버깅, 도메인 간 지식 통합이 필요한 작업에 적합합니다. Anthropic이 OpenCode의 API 접근을 차단한 뒤 GPT 기반으로 독립적으로 구축된 에이전트로, ‘The Legitimate Craftsman’이라는 별칭이 붙어 있습니다.

Prometheus(Plan Builder)

코드를 작성하기 전에 먼저 계획을 수립하는 전략 플래너입니다. 인터뷰 모드로 시작해 요구사항을 질문하고, 범위를 정의한 뒤 상세한 실행 계획을 문서로 작성합니다. 

준비가 되면 ‘make it a plan’이라고 입력하면 계획 파일이 생성되고, 이후 /start-work 명령어로 실행 단계로 넘어갑니다. 규모가 큰 프로젝트나 프로덕션 변경처럼 실행 전 검토가 중요한 작업에 적합합니다.

Atlas(Plan Executor)

Prometheus가 만든 계획을 실행하는 에이전트입니다. /start-work 명령어로 활성화되며, 태스크를 순서대로 처리하고 각 완료 여부를 독립적으로 검증합니다. 

세션이 종료되어도 진행 상태가 저장되어 다음 세션에서 이어서 작업을 계속할 수 있습니다.

오픈코드(OpenCode) 

실행 속도를 높여줄 명령어 모음

1. OpenCode 실행

opencode

OpenCode를 실행하는 명령어입니다. 터미널에서 OpenCode가 실행됩니다.

2. 프로젝트 초기화

/init

프로젝트 구조를 분석해 AGENTS.md 파일을 생성합니다. 의존성, 주요 파일, 코딩 패턴을 파악하며, 작업 시작 전 한 번 실행해두면 이후 AI가 프로젝트 맥락을 더 정확하게 이해합니다.

3. 새 세션 시작

/new

기존 맥락을 초기화하고 새 작업을 시작합니다. 세션은 별도 저장 명령 없이 자동으로 저장됩니다.

4. 변경 사항 되돌리기

/undo

마지막 메시지와 파일 변경 사항을 함께 되돌립니다. Git 기반으로 동작하므로 프로젝트가 Git 저장소여야 합니다.

5. 모델 목록 확인

/models

현재 연결된 프로바이더에서 사용 가능한 모델 목록을 확인할 수 있습니다. 모델 변경은 설정 파일(opencode.json) 또는 /connect 명령어를 통해 프로바이더를 추가하는 방식으로 이루어집니다.

오픈코드(OpenCode) 사용 시 

반드시 알아야 할 주의사항 3가지

1. 계정 연동 방식에 주의해야 합니다

OpenCode는 ChatGPT Plus/Pro 계정의 경우 opencode auth login 명령어로 직접 로그인해 사용할 수 있습니다. OpenCode v1.1.11부터 공식 지원이 추가된 방식입니다.

반면 Claude는 상황이 다릅니다. Anthropic은 2026년 1월 9일 서버 측 차단을 적용해 Claude Pro/Max 구독 계정의 OAuth 토큰을 OpenCode 등 서드파티 도구에서 사용하는 것을 공식적으로 금지했습니다. 이를 어길 경우 계정이 정지될 수 있으며, 실제 정지 사례도 다수 보고됐습니다. 

Claude 모델을 OpenCode에서 사용하려면 반드시 Anthropic API 키를 발급받아 연동해야 합니다.

Gemini도 공식적인 계정 연동 방식이 명확하지 않기 때문에, 구독 계정을 직접 연결하기보다 API 키 방식을 사용하는 것이 안전합니다.

2. 긴 세션은 구조적으로 관리해야 합니다

대화가 길어질수록 이전 지시와 충돌하거나, 의도와 다른 수정이 제안되거나, 토큰 한계로 맥락이 손실될 수 있습니다. 작업 단위를 명확히 나누고, 기능 단위로 세션을 분리하거나 큰 변경 전에 맥락을 정리하는 습관이 필요합니다. 

통제하지 않으면 AI가 ‘똑똑해 보이지만 엇나가는 상황’이 발생할 수 있습니다.

3. 모델 선택 전략이 필요합니다

멀티 모델 지원은 OpenCode의 강점이지만, 그만큼 어떤 모델을 언제 사용하는지에 대한 판단이 중요합니다.

OpenCode는 여러 LLM을 연결할 수 있는 구조이지만, 모든 모델이 동일한 추론 안정성과 코드 품질을 제공하는 것은 아닙니다. 

예를 들어, 정밀한 리팩토링이나 타입 안정성 강화, 복잡한 아키텍처 설계처럼 깊은 추론이 필요한 작업은 안정성이 높은 모델이 적합합니다. 반면, 코드 설명이나 로그 분석처럼 속도와 비용 효율이 중요한 작업은 다른 모델이 더 효율적일 수 있습니다. 

작업의 성격에 맞는 모델을 전략적으로 선택할수록 전체적인 개발 생산성과 결과 품질은 크게 달라집니다.

알아두면 오픈코드 작업 효율이 올라가는 콘텐츠 3가지

구글 안티그래비티 사용법, Antigravity를 직접 써보니 놀라웠습니다

Claude Code 사용법: 클로드 코드를 사용하지 않았던 게 가장 큰 실수였습니다

Claude Cowork 사용법 총정리, 클로드를 활용한 AI 에이전트로 자동화하기

AI 에이전트의 구조를 설계하고 

확장성과 안정성까지 책임질 수 있는 개발자, 

대한민국 최대 IT 프리랜서 매칭 플랫폼 이랜서에서 만나보세요.

이랜서는 27년간 IT 프로젝트를 매칭해온 대한민국 최대 IT 프리랜서 매칭 플랫폼입니다.

삼성 · 현대 · SK · 카카오 등 주요 기업과 함께한 8만 건 이상의 IT 프로젝트 매칭 경험을 바탕으로, 프로젝트에 가장 적합한 IT 프리랜서를 매칭합니다.

단순히 코드를 생성하는 개발자를 넘어, OpenCode와 같은 CLI 기반 AI 도구를 활용해 멀티 에이전트 구조를 설계하고, AI 모델을 전략적으로 선택하며, 보안 · 아키텍처 · 서비스 품질까지 함께 책임질 수 있는 개발자를 매칭합니다.

✓ 프로젝트 등록만 해도 약 41만 명의 IT 프리랜서 네트워크에 즉시 노출

✓ AI 시대에 맞는 기술 역량 중심의 개발자 추천

✓ 프로젝트 특성과 멀티 에이전트 활용 역량을 함께 고려한 정밀 매칭

AI 에이전트 시대, 구조 설계와 확장성까지 책임질 수 있는 개발자가 필요하다면 이랜서와 함께하세요

▶ AI 에이전트 기반 개발 전문가 매칭받기