BenPaperB

Claude Code 대신 이건 어때? — 오픈소스 AI 코딩 에이전트 'OpenCode' 총정리

· Ben's Paper 개발도구 오픈소스 AI뉴스 AI코딩 ClaudeCode OpenCode

Claude Code, Codex, Gemini CLI… 좋은데 하나씩 특정 회사에 묶여 있죠. 여기, "하나의 워크플로우로 아무 모델이나" 쓰자는 오픈소스 도구가 있습니다. 바로 OpenCode입니다. 최근 인기 튜토리얼 영상을 분석하고 공식 자료로 교차검증해, 무엇이고 어떻게 쓰는지 정리했습니다.

터미널 기반 오픈소스 AI 코딩 에이전트가 여러 AI 모델을 하나의 워크플로우로 연결하는 모습을 표현한 편집 일러스트

✔ 3줄 요약

  • OpenCode는 터미널 중심의 오픈소스(MIT) AI 코딩 에이전트입니다. Claude Code의 대안으로, 공식 사이트 기준 GitHub 16만+ 스타, 월 750만+ 개발자가 씁니다.
  • 가장 큰 차별점은 모델 자유입니다. OpenAI·Anthropic·Google 등 75개 이상 제공업체를 지원하고, 내 API 키나 기존 구독(ChatGPT·Copilot)을 그대로 붙일 수 있습니다.
  • 기능도 익숙합니다. build / plan 두 에이전트(Tab 전환), 세션 관리·공유, 그리고 스킬과 AGENTS.md로 동작을 표준화합니다.

이 글은 EricTech의 OpenCode 튜토리얼 영상을 AI로 분석한 뒤, 공식 사이트(opencode.ai)와 GitHub로 사실을 교차검증해 정리했습니다. "코딩 에이전트를 쓰고 싶은데 특정 회사에 종속되기는 싫다"면, 이 도구가 왜 화제인지 짚어보겠습니다.

이 글의 순서

  1. OpenCode란 무엇인가
  2. 핵심 차별점: "아무 모델이나"
  3. 설치와 기본 사용
  4. 확장: 스킬과 AGENTS.md
  5. Claude Code와 비교, 누구에게 맞나

OpenCode란 무엇인가

OpenCode는 터미널을 위해 만들어진 오픈소스 AI 코딩 에이전트입니다(라이선스 MIT). 공식 사이트에 따르면 GitHub 16만 개 이상의 스타, 900명 이상의 기여자, 월 750만 명 이상의 개발자가 사용합니다. 오픈소스 개발 도구로는 이례적인 규모입니다.

터미널 UI(TUI)를 중심으로, 세션 저장(로컬 SQLite), LSP(언어 서버) 통합, Vim 유사 에디터를 갖췄습니다. 그리고 중요한 점 하나 — 공식적으로 사용자의 코드나 컨텍스트를 저장하지 않습니다. 이 도구가 Claude Code와 어떻게 다른지는 뒤에서 비교하겠습니다. 먼저 최근 Claude Code의 새 기능들과 겹쳐 보면 흐름이 더 잘 보입니다.

핵심 차별점: "아무 모델이나"

OpenCode의 슬로건은 "One workflow. Any model."입니다. 대부분의 코딩 에이전트가 특정 회사 모델에 묶이는 반면, OpenCode는 75개 이상의 AI 제공업체를 지원합니다. OpenAI, Anthropic Claude, Google Gemini, AWS Bedrock, Groq, Azure, OpenRouter 등 — 골라 쓸 수 있습니다.

연결 방식도 유연합니다. 내 API 키를 직접 넣거나, 이미 쓰는 구독(ChatGPT Plus/Pro, GitHub Copilot 등)을 그대로 붙일 수 있습니다. 영상에 따르면 OpenCode 자체 게이트웨이(Zen)를 통해 무료·저가 모델부터 정액 구독까지 선택하는 흐름도 소개됩니다. "비싼 한 모델에 갇히지 않고, 작업에 맞는 모델을 그때그때 고른다"는 게 핵심 매력입니다. 코딩 에이전트 경쟁이 치열해지는 흐름은 중국 Z.ai의 무료 코딩 에이전트 ZCode에서도 확인됩니다.

핵심 포인트 ▸ 특정 모델의 성능 논쟁을 넘어, "모델을 갈아끼울 자유" 자체를 파는 도구라는 점이 OpenCode의 정체성입니다. 한 도구 안에서 무료 모델로 실험하고, 중요한 작업엔 최상위 모델로 갈아타는 식이죠.
하나의 터미널 워크플로우가 여러 AI 제공업체의 모델들과 연결되는 모습을 표현한 이미지

설치와 기본 사용

설치는 간단합니다. 공식 사이트 opencode.ai에서 제공하는 curl 설치 스크립트 한 줄이면 됩니다. 설치 후 프로젝트 폴더에서 opencode를 실행하면 바로 시작되고, VS Code 같은 IDE의 내장 터미널에서 쓰는 것을 권장합니다.

핵심은 두 개의 내장 에이전트입니다. 공식 문서 기준:

  • build — 기본값. 파일 생성·수정·명령 실행까지 하는 전체 접근 에이전트.
  • plan — 읽기 전용. 코드 탐색·분석용으로, 실제로 바꾸기 전에 계획을 세웁니다.

둘은 Tab 키로 오갑니다. 영상에서는 NestJS 서버를 프롬프트 한 줄로 스캐폴딩하고, /new(새 세션)·/sessions(세션 전환)로 작업을 관리하는 흐름을 보여줍니다. 또 /share로 대화를 웹 링크로 공유하거나, /export로 마크다운으로 내보내고, /timeline으로 과거 시점으로 되돌리는(파일 변경 포함) 기능도 시연됩니다. 자동화가 필요하면 opencode -p "프롬프트"로 단발 실행, -f json으로 JSON 출력, -q로 조용히 실행할 수 있습니다.

확장: 스킬과 AGENTS.md

OpenCode가 단순 채팅을 넘어서는 지점이 여기입니다.

스킬(Skills) — 재사용 가능한 작업 절차(SOP)를 에이전트에 얹습니다. 영상에 따르면 skills.sh 같은 플랫폼에서 스킬을 찾아(npx skills) 설치하고, 설치 후 재시작하면 /스킬이름으로 호출합니다. 특정 작업을 "매번 같은 방식으로" 처리하게 만드는 도구죠.

AGENTS.md — 에이전트의 시스템 프롬프트를 레포 차원에서 표준화하는 파일입니다. 저장소 역할, 규칙, 폴더 맵, 컨텍스트 처리 방식, 스킬 라우팅 등을 정의합니다. 영상에서는 /init 명령으로 현재 프로젝트 구조에 맞춰 이 파일을 자동 생성·갱신하고, 규칙을 추가하면 다음 세션부터 에이전트가 그대로 따르는 모습을 보여줍니다. 참고로 AGENTS.md는 여러 코딩 에이전트가 공유하기 시작한 사실상의 표준 형식으로 자리 잡는 중입니다.

AGENTS.md 설정 파일과 재사용 가능한 스킬로 AI 에이전트의 동작을 표준화하는 개념을 표현한 이미지

Claude Code와 비교, 누구에게 맞나

OpenCode는 Claude Code와 기능이 상당히 겹칩니다. plan/build 모드, 스킬, 서브에이전트, MCP, AGENTS.md 등 익숙한 개념이 대부분 있습니다. 결정적 차이는 모델 종속성입니다. Claude Code가 Anthropic 모델에 최적화돼 있다면, OpenCode는 어느 회사 모델이든 갈아끼우는 자유를 앞세웁니다.

균형 잡기 ▸ 그렇다고 "무조건 OpenCode"는 아닙니다. 특정 모델(예: Claude)에 깊게 최적화된 경험, 공식 지원, 생태계 성숙도에서는 각 순정 도구가 앞설 수 있습니다. 여러 모델을 자유롭게 오가며 비용을 최적화하고 싶다면 OpenCode, 한 모델의 최상위 경험을 원하면 해당 순정 도구가 맞습니다. (본문의 일부 세부는 영상 시연 기준이며, 버전에 따라 다를 수 있습니다.)

정리하면 OpenCode는 "모델 선택의 자유 + 오픈소스 + 터미널 친화"라는 조합으로, 다양한 모델을 실험하고 비용을 관리하려는 개발자에게 특히 매력적인 선택지입니다.

오늘 정리하고 갈 체크리스트

  • OpenCode = 터미널용 오픈소스(MIT) AI 코딩 에이전트, Claude Code 대안.
  • 핵심은 모델 자유 — 75개+ 제공업체, 내 API 키/기존 구독 연결.
  • 설치는 opencode.ai의 curl 한 줄. IDE 터미널에서 opencode 실행.
  • 내장 build/plan(Tab 전환), 세션 /share·/export·/timeline.
  • 확장은 스킬 + AGENTS.md(/init)로 동작 표준화.

자주 묻는 질문 (FAQ)

Q. OpenCode는 무엇인가요?

터미널을 위해 만들어진 오픈소스(MIT) AI 코딩 에이전트입니다. 공식 사이트 기준 GitHub 16만 개 이상의 스타, 월 750만 명 이상의 개발자가 사용합니다. Claude Code 같은 도구의 대안으로, 여러 AI 모델을 하나의 워크플로우에서 쓸 수 있는 것이 특징입니다.

Q. 어떤 AI 모델을 쓸 수 있나요?

OpenAI, Anthropic Claude, Google Gemini, AWS Bedrock, Groq, OpenRouter 등 75개 이상의 제공업체를 지원합니다. 자신의 API 키를 넣거나, ChatGPT Plus/Pro·GitHub Copilot 같은 기존 구독을 연결할 수도 있습니다.

Q. Claude Code와 무엇이 다른가요?

기능(plan/build 모드, 스킬, AGENTS.md 등)은 상당히 겹칩니다. 결정적 차이는 모델 종속성입니다. Claude Code가 Anthropic 모델에 최적화돼 있다면, OpenCode는 어느 회사 모델이든 자유롭게 갈아끼우는 것을 앞세웁니다. 다만 특정 모델에 깊게 최적화된 경험은 순정 도구가 앞설 수 있습니다.

Q. AGENTS.md는 무엇인가요?

에이전트의 동작을 레포 차원에서 표준화하는 설정 파일입니다. 저장소 역할, 규칙, 폴더 맵, 스킬 라우팅 등을 정의해 팀 전체가 일관된 에이전트 동작을 갖게 합니다. OpenCode에서는 /init 명령으로 자동 생성·갱신할 수 있으며, 여러 코딩 에이전트가 공유하는 사실상의 표준 형식이 되어가고 있습니다.

출처

벤자민 요한슨 주니어

글쓴이 · 벤자민 요한슨 주니어

국내외 AI·개발도구 뉴스를 매일 모니터링하며, 영상·공식 자료를 교차검증해 실용적으로 정리해 전달합니다. 더 많은 소식은 BenPaperB 홈에서 확인하세요.

※ 본문은 EricTech 튜토리얼 영상 분석과 OpenCode 공식 자료(opencode.ai)를 교차검증한 정리입니다. 기능·수치는 버전에 따라 달라질 수 있으니 공식 문서를 확인하세요.

댓글

댓글 남기기

Powered by Blogger