검증 리포트
OpenCode 고급 활용 핸드북의 콘텐츠 검증 및 업데이트 이력
이 문서는 OpenCode 고급 활용 핸드북의 콘텐츠 정확성과 업데이트 이력을 기록합니다.
검증 기준일
2026년 3월 26일 기준, OpenCode v1.3.2 공식 문서를 기반으로 검증했습니다. (3차 검증 완료)
업데이트 이력
2026.03.26 업데이트 (v1.3.2 기준)
v1.2.25 → v1.3.2 반영. 메이저 버전 업그레이드(v1.3.0) 포함.
변경 내역
| 챕터 | 변경 내용 |
|---|---|
| index.mdx | updatedAt 갱신, 버전 v1.3.2, v1.2.26~v1.3.2 하이라이트 Callout |
| Ch1. 설치/업데이트 | Node.js 런타임 지원 (v1.3.0), Interactive Update Flow (v1.3.0), 멀티윈도우 Electron (v1.2.27) |
| Ch7. TUI 고급 활용 | 커맨드 팔레트 Cmd+K (v1.3.1), 텍스트 첨부 (v1.2.26), 세션 히스토리 페이지네이션 (v1.2.26) |
| Ch9. 모델 선택 | Poe 인증 프로바이더 (v1.3.1), Amazon Bedrock 토큰 캐싱 (v1.3.1) |
| Ch10. 플러그인 확장 | Anthropic OAuth 플러그인 제거 Breaking (v1.3.0) |
| Ch11. GitHub & IDE | GitLab Agent Platform (v1.3.0), Git-backed Session Review (v1.3.0) |
| Ch12. LSP 코드 인텔리전스 | Kotlin/HCL/Lua/TOML 구문 강조 (v1.3.1), 힙 스냅샷 (v1.3.2) |
| Ch13. 공유/프라이버시 | 다단계 인증 Multistep Authentication (v1.3.0) |
3차 검증 결과
| 항목 | 검증 내용 | 결과 |
|---|---|---|
| v1.3.0 릴리즈 | GitHub releases 2026-03-22 확인 | 통과 |
| Anthropic OAuth 제거 | v1.3.0 릴리즈 노트 Breaking Changes 확인 | 통과 |
| GitLab Agent Platform | v1.3.0 릴리즈 노트 확인 | 통과 |
| Node.js 지원 | v1.3.0 릴리즈 노트 확인 | 통과 |
| Poe 인증 | v1.3.1 릴리즈 노트 확인 | 통과 |
| Bedrock 토큰 캐싱 | v1.3.1 릴리즈 노트 확인 | 통과 |
| 힙 스냅샷 | v1.3.2 릴리즈 노트 확인 | 통과 |
2026.02.28 업데이트 (v1.2.15 기준)
이전 버전(2026.01.29)에서 공식 문서를 기반으로 전면 업데이트했습니다.
변경 내역
| 챕터 | 변경 내용 |
|---|---|
| Ch1. 설치/업데이트 | Bun/pnpm/Yarn/mise 설치 추가, 데스크톱 앱(Beta) 추가, IDE 확장 단축키 추가, 설치 경로 우선순위 표 추가 |
| Ch2. 고급 설정 | 전체 설정 JSON 예시 추가, {env:}/{file:} 변수 치환 추가, AGENTS.md 규칙 시스템 신규 섹션, 환경 변수 표(10개) 추가, TUI 설정 분리(tui.json) 추가 |
| Ch3. 에이전트 설계 | 프라이머리/서브/시스템 에이전트 분류 표 추가, JSON/Markdown 커스텀 에이전트 구성 예시 추가, 에이전트 설정 옵션 표(11개) 추가, opencode agent create 추가 |
| Ch4. 권한 정책 | 3단계 권한 레벨 표 추가, Bash glob 패턴 구성 예시 추가, 서브에이전트 태스크 권한 추가, 에이전트별 권한 오버라이드 예시 추가, 실전 권한 설계 3단계 추가 |
| Ch5. 모드 활용 | Build/Plan 비교 표 추가, Plan → Build 2단계 워크플로우 상세화, 에이전트 기반 커스텀 모드 확장 예시 추가 |
| Ch6. 커스텀 커맨드 | 커맨드 Markdown frontmatter 예시 추가, 입력 변수 표($ARGUMENTS, $1, @, !) 추가, CLI 명령어 전체 표 추가, 비대화형 모드(opencode run) 추가, CLI 플래그 표 추가 |
| Ch7. TUI 고급 활용 | 슬래시 커맨드 17개 전체 표 추가, 입력 특수 기능(@, !, Tab, 드래그앤드롭) 추가, 키바인딩 시스템 4개 카테고리 전체 표 추가, tui.json 커스터마이즈 예시 추가 |
| Ch8. 포매터 자동화 | 포매터 설정 JSON 예시 추가, D/Clojure 포매터(v1.2.6) 추가, 동작 방식 플로우차트 추가, 프론트엔드/백엔드별 설정 탭 추가 |
| Ch9. 모델 선택 | 75+ 프로바이더 개요 추가, 퍼스트파티(Zen/Go) 설명 추가, 모델 선택 우선순위 표 추가, 모델 변형(Variants) 표 추가, 어댑티브 씽킹(v1.2.8) 추가, 커스텀 프로바이더 등록 JSON 예시 추가 |
| Ch10. 플러그인 확장 | 플러그인 API 코드 예시 추가, 훅 시스템 3개 카테고리 전체 표 추가, 커스텀 도구 플러그인 예시 추가, 서드파티 플러그인 표 추가 |
| Ch11. GitHub 통합 | → "GitHub & IDE 통합"으로 제목 변경, PR 리뷰 자동화 커맨드 예시 추가, CI/CD 통합(GitHub Actions) 추가, IDE 확장 상세(단축키 포함) 추가, GitHub Copilot 프로바이더 설정 추가, GitLab 플러그인 추가 |
| Ch12. ACP 연동 | → "LSP 코드 인텔리전스"로 교체, 29+ 언어 LSP 지원 표 추가, LSP 설정/비활성화 예시 추가, 커스텀 LSP 서버 등록 추가, 실험적 LSP 도구 추가, 서버 아키텍처(serve/web/attach) 추가 |
| Ch13. 공유/프라이버시 | 프라이버시 원칙 표 추가, 세션 공유 3가지 모드 표 추가, 엔터프라이즈 기능 5개 표 추가, 내부 AI 게이트웨이 구성 예시 추가, 가격 모델 추가 |
구조 변경
acp.mdx(Ch12. ACP 연동) →lsp.mdx(Ch12. LSP 코드 인텔리전스)로 교체- ACP는 공식 문서에서 별도 기능으로 확인되지 않아 실용성이 높은 LSP 통합으로 대체
meta.json목차에서acp→lsp로 변경
2026.03.13 업데이트 (v1.2.25 기준)
v1.2.15 → v1.2.25 (10개 릴리즈) 반영.
변경 내역
| 챕터 | 변경 내용 |
|---|---|
| index.mdx | updatedAt 갱신, 버전 v1.2.25, 10개 릴리즈 하이라이트 Callout |
| Ch1. 설치/업데이트 | ARM64 Windows 추가 (v1.2.25), 버전 핀 예시 갱신 |
| Ch3. 에이전트 설계 | Agent Skills 기능 추가 (SKILL.md, 디렉토리 검색, 권한 설정) |
| Ch7. TUI 고급 활용 | 컴팩트 UI 모드 (v1.2.16), 워크스페이스 TUI 지원 (v1.2.24) |
| Ch9. 모델 선택 | GPT-5.4 Codex/Copilot xhigh, Azure 비-OpenAI, Vertex AI 위치, SAP 추론, GitLab 1M 컨텍스트 |
| Ch10. 플러그인 확장 | @opencode-ai/sdk 공식 SDK 패키지 |
| Ch11. GitHub & IDE | ACP (Zed/JetBrains/Neovim), GitHub App 설치 |
2차 검증 결과
| 항목 | 검증 내용 | 결과 |
|---|---|---|
| v1.2.25 릴리즈 | GitHub releases 2026-03-12 확인 | 통과 |
| GPT-5.4 지원 | v1.2.19 릴리즈 노트 확인 | 통과 |
| ARM64 Windows | v1.2.25 릴리즈 노트 확인 | 통과 |
| ACP 지원 | 공식 문서 IDE 페이지 확인 | 통과 |
| Agent Skills | 공식 문서 agents 페이지 확인 | 통과 |
| 워크스페이스 TUI | v1.2.24 릴리즈 노트 확인 | 통과 |
| @opencode-ai/sdk | npm 레지스트리 확인 | 통과 |
2차 검증 외부 출처
| 출처 | 상태 |
|---|---|
| https://github.com/sst/opencode/releases | 200 |
| https://opencode.ai/docs | 200 |
| https://opencode.ai/changelog | 200 |
| https://www.npmjs.com/package/@opencode-ai/sdk | 200 |
2026.01.29 초판 발행
- 13개 챕터 + 검증 리포트 구성으로 초판 발행
검증 방법론
1단계: 공식 문서 교차검증
opencode.ai/docs의 각 문서 페이지와 GitHub README를 기반으로 본문 내용을 대조했습니다. 주요 검증 소스:
- OpenCode 공식 문서: https://opencode.ai/docs
- GitHub 리포지토리: https://github.com/sst/opencode
- 체인지로그: https://opencode.ai/changelog
2단계: 구조/용어 일관성
- 챕터 제목/설명 간 용어 불일치 여부 확인
- 동일 개념이 다른 용어로 섞여 쓰였는지 확인
3단계: 코드 예시 검증
- JSON 설정 예시가 공식 스키마(
https://opencode.ai/config.json)와 일치하는지 확인 - CLI 명령어 문법이 공식 CLI 문서와 일치하는지 확인
4단계: 링크 유효성
모든 참고 링크가 공식 문서/공식 사이트인지 확인했습니다.
검증 결과 요약
| 항목 | 결과 |
|---|---|
| 공식 문서 교차검증 | 통과 |
| 구조/용어 일관성 | 통과 |
| 코드 블록/JSON 스키마 | 통과 |
| CLI 명령어 문법 | 통과 |
| 공식 링크 유효성 | 통과 |
링크 유효성 확인 목록
검증 한계
범위 안내
본 리포트는 공식 문서 교차검증, 링크 유효성, 문서 내부 정합성을 검증했습니다. OpenCode의 빈번한 릴리즈 주기(주 2–3회)로 인해 세부 기능이 변경될 수 있으므로, 최신 정보는 항상 공식 체인지로그를 참고하세요.