Open Code 리뷰(1) : OpenCode 설치 및 설정, 기본 명령어 살펴보기

OpenCode 입문 — 설치·설정·기본 사용법 (갓대희 리뷰 Part 1)

Key Insight

OpenCode는 75개 이상 LLM을 지원하는 오픈소스 AI 코딩 에이전트. Anthropic이 Claude Pro/Max OAuth를 써드파티 도구에서 차단(2026-01-09)했으므로 반드시 API 키 방식을 사용해야 한다. Oh-My-OpenAgent의 베이스 플랫폼.

출처: https://goddaehee.tistory.com/484 타입: 블로그 (갓대희) 작성자: 갓대희 유효일: 2026-01-09 (마지막 주요 업데이트) 시리즈: OpenCode 시리즈 Part 1 (Part 2 | Part 3 | Part 4)

핵심 Takeaway

• OpenCode는 SST(Serverless Stack) 팀이 개발한 오픈소스 AI 코딩 에이전트 — 75개+ LLM 제공자 지원, 45,000+ GitHub ⭐, 월 650,000+ 개발자 사용 (valid_as_of 2026-01-09)
• Anthropic OAuth 차단 (2026-01-09): Claude Pro/Max 구독 OAuth는 써드파티 도구에서 공식 차단 → OpenCode에서 Claude 사용 시 API 키 방식만 안전
• OpenCode Zen: 코딩 에이전트 최적화 모델 게이트웨이 — 제로 마크업(신용카드 수수료 4.4%+$0.30만), 베타 무료 모델 제공 (Grok Code Fast 2, GLM 4.7, MiniMax M2.1 등)
• GLM-4.7: 400B 파라미터, 200K 컨텍스트, AIME 2025 95.7% (GPT-5.1 94.0% 상회), Claude 대비 약 85% 비용 절감 (valid_as_of 2026-01-09)
• OpenAI vs Anthropic 대조: OpenAI는 ChatGPT Plus/Pro Codex OAuth를 써드파티 공식 지원 ↔ Anthropic은 차단

상세 요약

OpenCode 개요

OpenCode는 터미널·데스크톱·IDE 확장 세 가지 환경에서 실행 가능한 오픈소스 AI 코딩 에이전트다. 코드나 컨텍스트를 외부에 저장하지 않아 프라이버시 민감 환경에서도 사용 가능하다. Oh-My-OpenAgent의 베이스 플랫폼이기도 하다.

설치 방법

# npm
npm install -g opencode-ai
 
# yarn
yarn global add opencode-ai
 
# bun
bun add -g opencode-ai
 
# macOS Homebrew
brew install anomalyco/tap/opencode

설치 확인: opencode --version

LLM 제공자 연결 (/connect)

OpenCode 실행 후 /connect 명령으로 대화형 LLM 연결. API 키는 ~/.local/share/opencode/auth.json에 저장.

설정 파일 직접 편집:

• 전역: ~/.config/opencode/opencode.json
• 프로젝트: 루트 디렉토리 opencode.json

{
  "model": "anthropic/claude-sonnet-4-5",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

Claude 연동 시 주의사항 (2026-01-09 업데이트)

Anthropic OAuth 차단

Anthropic이 Claude Code OAuth 토큰을 제3자 도구에서 사용 불가하도록 기술적 제한 적용. Thariq Shihipar(Anthropic 기술 스태프)가 2026-01-10 X에서 공식 확인.

• 차단: Claude Pro/Max 구독 OAuth 방식 (ToS 위반, 계정 차단 사례 있음)
• 허용: Anthropic API 키 방식 (console.anthropic.com에서 발급)

OpenCode Zen — 모델 게이트웨이

분류	내용
가격	제로 마크업 (신용카드 수수료 4.4%+$0.30만)
무료 모델 (베타)	Grok Code Fast 2, GLM 4.7, MiniMax M2.1, Big Pickle, GPT 5 Nano
프라이버시	미국 호스팅, 제로 리텐션 (무료 모델 제외)

Dated Claim

무료 모델 목록 및 가격은 변동될 수 있음 — 2026-01-09 기준

OpenCode Black — 구독 플랜

플랜	월 요금
Black 20	$20
Black 100	$100
Black 200	$200

Claude Opus 4.5/4.1, Sonnet 4.5/4, Haiku 4.5/3.5, GPT 5.x, Gemini 3.x 포함.

GLM-4.7 주요 지표

벤치마크	GLM-4.7	비고
AIME 2025	95.7%	GPT-5.1(94.0%) 상회
SWE-bench Verified	73.8%	오픈소스 최상위권
비용	Claude 대비 ~85% 절감	”설계는 Claude, 구현은 GLM” 전략

Dated Claim

벤치마크 수치 — LLM Stats 2025-12 기준

기본 내장 명령어

명령어	기능
/init	프로젝트 분석 + AGENTS.md 생성
/connect	LLM 제공자 연결
/undo / /redo	변경 되돌리기/재적용
/share	대화 공유 링크 생성
/models	사용 가능 모델 목록·전환
/help	도움말

에이전트: Build vs Plan

• Build 에이전트: 기본값, 바로 코드 작성 실행
• Plan 에이전트: 먼저 계획 수립 후 승인받아 실행

연결되는 노트

• OpenCode — 이 기사의 주인공
• Oh-My-OpenAgent — OpenCode 기반 에이전트 하네스
• oh-my-openagent-github-readme — OmO 공식 README