OpenCode 리뷰 — 오픈소스 터미널 AI 코딩 에이전트

터미널에서 AI와 함께 코드를 작성하는 방식이 빠르게 확산되고 있습니다. Claude Code가 사실상 이 분야의 기준점을 세운 이후로, 다양한 오픈소스 도구들이 등장하기 시작했습니다. 그중에서도 OpenCode는 GitHub에서 12만 개가 넘는 스타를 받으며 가장 빠르게 성장한 프로젝트 중 하나입니다. Anomaly 팀이 만든 이 도구는 Neovim 사용자들이 주도해 개발했으며, 터미널 인터페이스에 최대한 공을 들인 것이 특징입니다.

이 리뷰는 Windows + WSL 환경을 기준으로 작성했습니다. OpenCode를 직접 설치하고 써보면서 느낀 장점과 아쉬운 점, 가격 구조, 그리고 Claude Code와의 차이점을 솔직하게 정리했습니다.

OpenCode가 뭔지

OpenCode는 터미널에서 동작하는 오픈소스 AI 코딩 에이전트입니다. MIT 라이선스로 공개되어 있으며, 특정 AI 제공자에 묶여 있지 않다는 것이 가장 큰 차별점입니다. Anthropic, OpenAI, Google, Groq, AWS Bedrock, Azure OpenAI, OpenRouter 등 75개 이상의 제공자와 모델을 지원합니다.

핵심 인터페이스는 TUI(Terminal User Interface)입니다. Bubble Tea 라이브러리로 만든 대화형 터미널 화면에서 AI에게 질문하고, 코드를 수정하고, 파일을 탐색할 수 있습니다. 동시에 헤드리스 서버 모드로도 실행할 수 있어서, 모바일 앱이나 웹 인터페이스에서 원격으로 제어하는 것도 가능합니다.

핵심 기능

OpenCode는 단순한 AI 채팅 도구가 아닙니다. 코딩 작업에 필요한 실질적인 기능들을 터미널 안에서 모두 처리할 수 있도록 설계되어 있습니다.

TUI 인터페이스

터미널을 실행하면 채팅 화면이 바로 뜹니다. 왼쪽에는 세션 목록, 오른쪽에는 현재 대화가 표시됩니다. @파일명 형식으로 특정 파일을 대화에 첨부할 수 있고, Tab 키로 계획(Plan) 모드와 빌드(Build) 모드를 전환할 수 있습니다. 계획 모드에서는 AI가 실제 파일을 수정하지 않고 변경 계획만 제안합니다.

$ opencode
╭─────────────────────────────────────────╮
│  OpenCode  v0.4.x                       │
│  /path/to/your/project                  │
│                                         │
│  /connect  모델 연결                    │
│  /models   모델 선택                    │
│  /init     프로젝트 초기화              │
│  /help     도움말                       │
╰─────────────────────────────────────────╯
> 

/undo 명령어를 쓰면 AI가 변경한 파일을 이전 상태로 되돌릴 수 있습니다. 내부적으로 Git을 사용하는 방식이라 프로젝트가 Git 저장소여야 합니다. /share 명령어로 현재 세션의 링크를 생성해서 팀원과 공유하는 것도 가능합니다.

LSP 내장 지원

OpenCode는 Language Server Protocol을 기본으로 지원합니다. 언어 서버를 연결하면 AI가 diagnostics 도구를 통해 코드 오류를 실시간으로 확인하고 수정 방향을 제안할 수 있습니다. TypeScript, Go, Python 등 LSP를 지원하는 모든 언어에서 활용할 수 있습니다.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript-language-server": {
      "command": "typescript-language-server",
      "args": ["--stdio"]
    },
    "go": {
      "command": "gopls"
    }
  }
}

커스텀 에이전트와 도구 권한

프로젝트 루트의 opencode.json 파일로 목적별 에이전트를 정의할 수 있습니다. 예를 들어 코드 리뷰 전용 에이전트에는 파일 쓰기 권한을 막고, 빌드 에이전트에는 bash 실행을 허용하는 방식으로 세밀하게 제어할 수 있습니다.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "agent": {
    "build": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-4-20250514",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "code-reviewer": {
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4-20250514",
      "prompt": "You are a code reviewer. Focus on security and performance.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

지원 모델

OpenCode는 AI SDK와 Models.dev를 통해 75개 이상의 LLM 제공자와 연동됩니다. 공식 문서에서 코딩 에이전트와 궁합이 좋다고 검증한 추천 모델 목록도 제공합니다.

Windows + WSL 설치 방법

OpenCode는 공식적으로 Windows 네이티브도 지원하지만, Chocolatey나 Scoop, npm을 통해 설치할 수 있습니다. 공식 문서는 WSL 사용을 권장합니다. 파일 시스템 성능과 터미널 통합 품질이 WSL 환경에서 훨씬 좋기 때문입니다.

WSL 터미널을 열고 아래 명령어 중 하나로 설치합니다.

curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai

brew install anomalyco/tap/opencode

설치 후 Windows 드라이브의 프로젝트 폴더로 이동해서 실행합니다. C 드라이브는 /mnt/c/ 경로로 접근합니다.

$ cd /mnt/c/Users/YourName/projects/my-app
$ opencode
# 또는 WSL 홈 디렉터리에 프로젝트를 두면 성능이 더 좋습니다
$ cd ~/code/my-app
$ opencode

모델 연결은 TUI 안에서 /connect 명령어를 입력하고 제공자를 선택한 뒤 API 키를 붙여 넣으면 됩니다. 자격증명은 ~/.local/share/opencode/auth.json에 저장됩니다.

장단점

OpenCode를 써보면서 실제로 느낀 장점과 아쉬운 점을 정리했습니다. 특히 Claude Code와 비교하며 어디서 차이가 나는지 주목해서 봤습니다.

가격

OpenCode 자체는 무료입니다. 비용은 사용하는 AI 모델의 API 사용료에서 발생합니다. 초보자를 위해 OpenCode 팀은 두 가지 자체 유료 서비스를 운영합니다.

Claude Code와 비교

OpenCode 공식 문서에는 "Claude Code와 기능 면에서 매우 유사하지만 몇 가지 핵심 차이가 있다"고 직접 명시되어 있습니다. 실제로 사용해보면 두 도구의 접근 방식이 상당히 다릅니다.

자율적인 멀티 파일 에이전틱 작업에서는 Claude Code가 아직 한발 앞서 있다는 평가가 많습니다. 하지만 OpenCode는 특정 제공자에 종속되지 않고 원하는 모델을 자유롭게 쓸 수 있다는 점에서 실무 유연성이 훨씬 높습니다.

버전 히스토리

누구에게 추천하는지

OpenCode가 특히 잘 맞는 사람과 맞지 않는 사람을 분명히 나눌 수 있습니다.

추천합니다

터미널을 주 작업 환경으로 쓰는 개발자라면 OpenCode의 TUI가 즉시 손에 익습니다. 특히 여러 AI 제공자를 프로젝트마다 다르게 쓰고 싶거나, Claude 하나에 종속되고 싶지 않은 경우에 가장 잘 맞습니다. 오픈소스라 내부를 직접 뜯어볼 수 있고, 자체 서버에서 실행하거나 CI 파이프라인에 통합하고 싶은 경우에도 OpenCode가 유리합니다. LSP를 통한 실시간 진단 연동이 필요한 TypeScript, Go 개발자에게도 Claude Code보다 명확한 장점이 있습니다.

비추천합니다

터미널이 낯설고 GUI 기반 IDE를 선호한다면 OpenCode보다 Cursor나 Windsurf 같은 에디터 기반 도구가 더 적합합니다. Claude 모델을 가장 심도 있게 활용하고 싶고, 복잡한 자율 에이전틱 작업을 주로 한다면 현시점에서는 Claude Code가 한발 앞서 있습니다. 설정 없이 바로 쓰기를 원한다면 OpenCode의 초기 구성이 다소 번거롭게 느껴질 수 있습니다.

자주 묻는 질문