OpenCode

75개 이상의 AI 프로바이더에 붙는 오픈소스 터미널 코딩 에이전트

npm install -g opencode-ai@latest

sst(현 Anomaly) 팀이 만든 오픈소스 터미널 코딩 에이전트입니다. 75개 이상의 AI 프로바이더(Claude, GPT, Gemini, GitHub Copilot, 로컬 Ollama 등)에 연결되며 로컬에서 실행되고 대화 기록을 SQLite에 저장합니다. MIT 라이선스라 전체 코드를 열람·수정·자체 호스팅할 수 있습니다.

판단

이럴 때 씁니다

Claude/OpenAI 구독료 없이 이미 갖고 있는 다른 프로바이더(로컬 Ollama, Gemini 무료 티어, OpenRouter 등)로 터미널 코딩 에이전트를 쓰고 싶을 때
대규모 리포에서 여러 세션을 병렬로 동시에 돌려야 할 때(parallel multi-session)
MCP 서버·플러그인으로 사내 도구를 직접 붙이면서, 완전 오픈소스라 내부 감사나 포크가 필요한 조직
opencode pr <number>로 GitHub PR을 바로 체크아웃해 리뷰-수정 루프를 돌리고 싶을 때

이럴 땐 쓰지 마세요

Anthropic의 최신 Claude 기능(서브에이전트, 백그라운드 세션 등)을 가장 먼저 받고 싶다면 Claude Code가 아직 더 앞서 있습니다(리뷰들이 공통 지적)
GUI 에디터 플러그인 형태(Cursor/Copilot류)를 원한다면 해당 없음 — OpenCode는 터미널·데스크톱 앱 중심입니다
어떤 모델을 쓸지 스스로 고르고 싶지 않고 단일 벤더 통합만 원하는 팀에는 75개 프로바이더 선택지가 오히려 설정 부담이 됩니다

차별점

75개 이상의 프로바이더(Models.dev 경유)에 연결됩니다 — Claude, GPT, Gemini, GitHub Copilot은 물론 로컬 Ollama 모델까지 opencode.json 설정 하나로 전환합니다(공식 사이트/README에서 확인).
opencode run·opencode session·opencode export/import처럼 세션을 SQLite에 저장하고 JSON으로 내보내는 CLI 서브커맨드를 갖추고 있습니다 — 직접 --help로 확인한 명령 목록입니다.
opencode pr <number> 명령으로 GitHub PR을 바로 체크아웃해 리뷰-수정 루프를 실행하고, opencode github로 GitHub 연동 에이전트를 별도로 관리합니다.
MIT 라이선스에 835개 이상의 릴리스 이력을 가진 완전 오픈소스 프로젝트라, opencode plugin으로 사내 플러그인을 추가하거나 통째로 포크하는 데 제약이 없습니다.

워크플로

01curl -fsSL https://opencode.ai/install | bash 또는 npm install -g opencode-ai@latest로 설치
02opencode providers(별칭 auth)로 원하는 프로바이더 API 키를 연결하거나 opencode.json에 provider 옵션 지정
03프로젝트 루트에서 opencode 실행 후 /init으로 AGENTS.md 생성
04Tab 키로 build/plan 에이전트를 전환하며 작업, 필요하면 opencode agent로 커스텀 에이전트 정의
05opencode run "메시지"로 비대화형 실행하거나 opencode -c로 세션 이어가기
06opencode stats로 토큰/비용 확인, opencode export로 세션을 JSON으로 백업

주요 명령

명령	설명
`opencode run "메시지"`	비대화형으로 메시지 한 번을 실행하고 종료합니다(파이프 입력 가능) — --help로 직접 확인
`opencode -c`	현재 디렉터리의 가장 최근 세션을 이어서 엽니다(--continue)
`opencode providers`	AI 프로바이더 자격증명을 관리합니다(별칭: opencode auth)
`opencode mcp`	MCP(Model Context Protocol) 서버를 관리합니다
`opencode stats`	토큰 사용량과 비용 통계를 보여줍니다

설정

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5",
  "provider": {
    "anthropic": { "options": { "timeout": 600000 } }
  },
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices",
      "model": "anthropic/claude-sonnet-4-5",
      "tools": { "write": false }
    }
  },
  "autoupdate": true
}

함정

설치 전에 확인하세요

--auto 플래그는 명시적으로 거부되지 않은 모든 권한을 자동 승인합니다 — opencode --help 자체가 이 옵션을 'dangerous!'라고 표시해 둘 만큼 위험한 옵션입니다(직접 실행해 확인).
설정이 글로벌(~/.config/opencode/opencode.json)과 프로젝트 opencode.json 사이에서 override가 아니라 병합(merge)되는 구조라, 팀에서 쓸 때 글로벌 설정이 조용히 프로젝트에 섞여 들어갈 수 있습니다(공식 문서 확인).

직접 써본 메모

스타 수만 보면 OpenCode는 이미 오픈소스 코딩 에이전트 카테고리의 1위입니다. sst(현 Anomaly) 팀이 만든 이 도구는 2026년 상반기 동안 Gemini CLI(약 10만)와 Codex CLI(약 9만)를 제치고 18만 스타를 넘겼습니다. 다만 스타 수와 실사용 완성도는 별개입니다.

amux.io의 2026년 터미널 에이전트 비교 글은 "OpenCode는 Claude Code와 거의 같은 형태를 하고 있지만 MIT 라이선스이고 원하는 모델을 아무거나 붙일 수 있다"고 정리하면서도, "자율적인 멀티파일 에이전틱 작업에서는 Claude Code가 여전히 앞서 있다"고 지적합니다. openaitoolshub.org의 리뷰 역시 75개 이상 프로바이더 연결이 강점이라면서도, 이는 동시에 매번 어떤 모델을 쓸지 결정해야 하는 설정 부담으로 이어질 수 있다고 언급합니다.

실제로 --help 출력을 직접 확인해보면 --auto 플래그에 대해 OpenCode 스스로 "auto-approve permissions that are not explicitly denied (dangerous!)"라는 경고 문구를 붙여둘 만큼, 승인 없는 자동 실행의 위험성을 명시적으로 인지하고 있습니다. 설정 파일이 글로벌·프로젝트 단위로 병합(merge)되는 구조도 팀 단위로 쓸 때는 미리 파악해둘 부분입니다.

비교

Claude Code는 Anthropic 모델에 최적화되어 있고 codex-cli는 OpenAI 계열, gemini-cli는 구글 계열로 각각 특정 벤더에 묶여 있는 반면, OpenCode는 75개 이상의 프로바이더를 opencode.json 설정 하나로 오갈 수 있습니다. 다만 여러 리뷰가 공통적으로 지적하듯 자율적 멀티파일 작업의 완성도는 아직 Claude Code가 앞서 있습니다.

최근 변경

1.18.7에서 데스크톱 전체 화면 여백, 명령 팔레트 가림과 프로젝트 선택기 스크롤 문제가 수정됐다.

공식 변경 내역