OpenCode 고급 활용
시니어 개발자를 위한 OpenCode 자동화, 운영 설정, 팀 활용 팁을 정리한 가이드
최근 수정된 챕터
.opencode/commands/의 Markdown 커맨드 작성법, $ARGUMENTS·@파일·!셸 변수 참조, opencode run 비대화형 실행과 CI 코드 리뷰 자동화를 정리합니다.
opencode.json 6단계 구성 파일 우선순위, env·file 변수 치환, AGENTS.md 규칙 시스템, tui.json 분리와 .well-known 원격 설정을 다룹니다.
opencode.json의 format 키로 확장자별 포매터를 지정해 파일 변경 시 prettier·black·gofmt 등을 자동 실행하고, 프론트/백엔드 팀 표준을 강제하는 방법입니다.
bash 도구 기반 Git 작업, VS Code 계열·ACP를 통한 IDE 연동, GitHub App(/oc) 호출, GitLab Agent Platform, v1.3.0 Git-backed 세션 리뷰를 정리합니다.
29개+ 내장 LSP 서버의 자동 실행, lsp 키를 통한 초기화·커스텀 서버 등록·비활성화, 실험적 LSP 도구와 클라이언트/서버 아키텍처를 다룹니다.
OpenCode는 75+ 프로바이더를 지원하는 오픈소스 AI 코딩 에이전트입니다. 이 핸드북은 시니어 개발자가 실전에서 바로 쓸 수 있는 고급 팁과 운영 패턴을 정리합니다.
대상 독자
OpenCode를 이미 사용하고 있으며, 팀/프로젝트 단위로 안정적으로 운영하려는 개발자. v1.3.2 (2026.03.24) 기준으로 작성되었습니다.
v1.3.2 업데이트 (2026-03-26)
v1.2.25 이후 주요 변경사항:
- v1.3.0 (메이저): Anthropic OAuth 플러그인 제거 (Breaking), GitLab Agent Platform, Git-backed Session Review, 다단계 인증, Node.js 지원
- v1.3.1: Poe 인증 프로바이더, Amazon Bedrock 토큰 캐싱, Kotlin/HCL/Lua/TOML 구문 강조, 커맨드 팔레트 Cmd+K
- v1.3.2: 힙 스냅샷 기능
- v1.2.26-27: 세션 히스토리 페이지네이션, 텍스트 첨부, 멀티윈도우 Electron
핸드북 구성
목차
Ch1. 설치/업데이트
설치 채널, 데스크톱 앱, IDE 확장, 팀 표준화
Ch2. 고급 설정
구성 파일 계층, AGENTS.md, 환경 변수, 원격 설정
Ch3. 에이전트 설계
빌트인/커스텀 에이전트, 역할 분리, 도구 제한
Ch4. 권한 정책
Bash glob 패턴, 서브에이전트 권한, 안전한 기본값
Ch5. 모드 활용
Build/Plan 전환, 에이전트 기반 모드 확장
Ch6. 커스텀 커맨드
커맨드 작성, CLI 명령어, 비대화형 실행
Ch7. TUI 고급 활용
슬래시 커맨드, 키바인딩, 세션 관리
Ch8. 포매터 자동화
언어별 포매터 설정, 자동 실행
Ch9. 모델 선택
75+ 프로바이더, 비용 최적화, 커스텀 프로바이더
Ch10. 플러그인 확장
플러그인 API, 훅 시스템, 커스텀 도구
Ch11. GitHub & IDE 통합
Git 워크플로우, IDE 확장, GitLab 연동
Ch12. LSP 코드 인텔리전스
29+ 언어 LSP, 서버 아키텍처, 원격 운영
참고 문서
- OpenCode 공식 사이트: https://opencode.ai
- OpenCode 공식 문서: https://opencode.ai/docs
- 체인지로그: https://opencode.ai/changelog
- GitHub: https://github.com/sst/opencode