opencode-guide

🚀 시니어 직장인의 AI 탐구기: 오픈코드(OpenCode) 완벽 실전 가이드

“코딩을 몰라도 괜찮습니다. 내 컴퓨터 옆자리에 든든한 AI 신입사원을 두고 퇴근 시간을 앞당겨 보세요!”
본 블로그는 시니어 직장인의 현실적인 눈높이에서 오픈소스 AI 에이전트 오픈코드(OpenCode)의 설치부터 글로벌 AI 모델 연동, 고급 스킬(Skills) 확장, 한글(HWP) 공문서 자동화, 그리고 Plan 모드를 활용한 실전 웹앱 개발까지 체계적으로 정리한 실무 지침서입니다.

📚 전체 연재 시리즈 목차 (Table of Contents)

[Part 1] 기초 입문 & 필수 AI 환경 세팅

기초 개념 이해부터 Mac/Windows 설치, 구글 제미나이 및 ChatGPT 데스크탑 환경 구축까지 다룹니다.

[Part 2] 비용 최적화 & 모델 연동, 인터페이스 마스터

선결제 요금 통제, 자체 무료 모델(DeepSeek V4.1) 활용, 2분할 화면 조작법 및 /connect 원클릭 연동을 배웁니다.

[Part 3] 파워 스킬(Skills) 장착 & 한국형 문서 자동화

오픈소스 우선 탐색, 고품질 인터랙티브 다이어그램 생성, HWP 공문서 파싱 및 만능 메타 스킬을 구축합니다.

[Part 4] 실전 프로젝트 개발 & AI 페어 프로그래밍

내 컴퓨터 전용 작업대(프로젝트 폴더) 구축부터 Plan(계획) 모드를 통한 안전한 코드 제어, 인앱 브라우저 실시간 검증 및 로컬스토리지 칸반 보드 구축까지 다룹니다.

[Part 5] 유튜브 학습 & OpenCode 초보자 튜토리얼

유튜브 영상 자막을 추출·요약하는 스킬부터 OpenCode 설치, 모델 연결, Plan/Build 작업, 슬래시 명령어, Skills·MCP·AGENTS.md·GitHub까지 초보자용 3부작으로 살펴봅니다.

[#15편] 유튜브 자막 추출 및 AI 요약 스킬 ‘baoyu-youtube-transcript’ 설치·활용
[#16편] OpenCode 데스크톱 첫걸음: 설치부터 모델 연결, 프로젝트 만들기까지
[#17편] Plan·Build 모드와 Git으로 안전하게 앱 만들기
[#18편] Skills와 MCP, 슬래시 명령어부터 AGENTS.md·GitHub까지

[Part 6] 실무 생산성 극대화: PDF·오피스 문서 분석 & 토큰 최적화

마이크로소프트의 MarkItDown과 초고속 uv를 이용해 PDF, 워드, 엑셀 문서를 처리하고 대용량 문서 분석 시 토큰 비용을 최소화하는 실무 노하우를 다룹니다.

[#19편] uv로 완성하는 PDF·오피스 문서 처리! Microsoft MarkItDown 설치부터 OpenCode MCP 연동 & 토큰 절약 노하우

[Part 7] 멀티 에이전트 협업: 서브에이전트(Subagents)와 전문가 팀 구축

혼자 일하는 AI를 넘어 탐색(explore), 수학 검증, 코드 리뷰, 테스트 전담 등 역할을 나누어 안전하고 정밀하게 협업하는 서브에이전트 실전 구축 노하우를 다룹니다.

[#20편] 혼자 일하는 AI에서 전문가 팀으로: 오픈코드 데스크톱 서브에이전트(Subagents) 실전 구축 가이드

[Part 8] 한국형 오피스 통합 & AI 문서 자동화의 진화

한컴오피스·MS 오피스 없이 HWP/HWPX부터 워드, 엑셀, PPT, PDF, 마인드맵, 다이어그램까지 한 창에서 열고, 오픈코드와 MCP·CLI로 연결해 AI가 문서 원본을 직접 편집하는 화제의 무료 오픈소스 ‘이음오피스(IeumOffice)’를 다룹니다.

[#21편] 한글(HWP)부터 오피스·다이어그램까지 한 창에서! 국어 교사가 만든 무료 오픈소스 ‘이음오피스(IeumOffice)’ 완벽 가이드 & 오픈코드 연동

[Part 9] AI 소통 사전 & 필수 개념 총정리

사내 AI 회의나 유튜브 강좌, 프롬프트 작성 시 매일 마주치는 LLM·RAG·토큰·MCP·에이전트 등 필수 핵심 용어 30가지를 시니어 직장인의 눈높이에 맞춘 일상 비유와 오픈코드 실전 팁으로 총정리합니다.

[#22편] AI 대화가 술술 풀리는 마법의 사전: 시니어 직장인을 위한 생성형 AI 핵심 필수 용어 30선

🎁 [실전 실습 프로젝트]

[실전 사례] 특정소방대상물의 관계인이 설치·관리해야 하는 소방시설 (법령 HWP → MD 자동 변환)

📑 전체 연재 글 한눈에 보기

회차	주제 및 제목	바로가기	핵심 학습 내용
#01	오픈코드(OpenCode) 소개	읽어보기	AI 코딩 에이전트 개념 및 시니어 직장인 활용 가치
#02	오픈코드 데스크탑 & CLI 설치	읽어보기	Mac / Windows 운영체제별 설치 및 첫 실행
#03	구글 안티그래비티 (Gemini) 설치	읽어보기	제미나이 모델을 오픈코드 에이전트로 업그레이드
#04	ChatGPT 데스크탑 & CLI 설치	읽어보기	OpenAI 유료 구독자 데스크탑 및 터미널 인증
#05	오픈코드 콘솔 가입 & 선결제	읽어보기	요금 폭탄 없는 $10 선불 크레딧 충전 및 관리
#06	무료 모델 DeepSeek V4.1 활용	읽어보기	비용 0원으로 고성능 추론 모델 10초 만에 선택
#07	오픈코드 Mac 2분할 화면 가이드	읽어보기	좌우 분할 창 명칭, Open file 및 Terminal 단축키
#08	`/connect` 3대 제공자 연동	읽어보기	구글, ChatGPT, 콘솔 원클릭 브라우저 OAuth 인증
#09	검색 스킬 ‘research-first’	읽어보기	오픈소스 라이브러리와 템플릿 우선 검색 습관
#10	다이어그램 스킬 ‘archify’	읽어보기	Workflow, Timeline 인터랙티브 HTML 시각화
#11	HWP 파서 MCP ‘kordoc’	읽어보기	맥북에서도 한컴오피스 없이 HWP/HWPX 읽기·요약
#12	메타 스킬 ‘find-skills’	읽어보기	전 세계 skills.sh 레지스트리 자동 탐색 및 설치
#13	새 프로젝트 생성 & 폴더 연결	읽어보기	보안 격리 및 AI 작업대 배정, 폴더 열기 3단계
#14	Plan 모드로 칸반 보드 제작	읽어보기	Plan 모드(diff 사전 검토), 브라우저 검증, 로컬 칸반 보드, AGENTS.md
#15	유튜브 자막 추출·요약 스킬	읽어보기	`baoyu-youtube-transcript` 검색·설치, 자막과 영상 정보 활용
#16	OpenCode 설치와 첫 프로젝트	읽어보기	데스크톱 시작, 제공자·모델 연결, 프로젝트 작업대 준비
#17	Plan·Build 모드와 Git	읽어보기	계획 검토, 실습 앱 구현, 변경 사항 확인 및 Git 관리
#18	Skills·MCP·AGENTS.md·GitHub	읽어보기	슬래시 명령어, 확장 기능 구분, 프로젝트 규칙과 GitHub 연결
#19	MarkItDown & 토큰 최적화	읽어보기	uv로 MarkItDown MCP 설치, PDF/Office 문서 변환 및 토큰 절약 5대 수칙
#20	데스크톱 서브에이전트 구축	읽어보기	explore 기본 탐색부터 math·reviewer·tester 전문가 팀 등록 및 권한 통제
#21	이음오피스(IeumOffice) 가이드	읽어보기	한글·오피스 한 창 통합 편집, 인터넷 반응 5대 호평, OS별 설치 및 OpenCode MCP·CLI 연동
#22	AI 핵심 필수 용어 30선	읽어보기	LLM·RAG·토큰·MCP·에이전트 등 5대 테마 30대 필수 용어 및 프롬프트 실전 팁

🧭 처음 읽는 분께

처음이라면 #01부터 순서대로 읽는 것을 권합니다. 이미 OpenCode를 설치했다면 #13~#22의 프로젝트 실습과 활용법부터 살펴보셔도 좋습니다. 글마다 기능과 화면이 달라질 수 있으므로, 설치·요금·모델 관련 내용은 해당 서비스의 최신 공식 안내도 함께 확인하세요.

🛠️ 권장 실습 환경

구분	권장 사양 및 환경
운영체제	macOS (Apple Silicon / Intel) 또는 Windows 10/11
필수 소프트웨어	OpenCode Desktop (v2.x 이상), Node.js (v18 이상), Git
연동 계정	Google 계정, OpenAI(선택), OpenCode Console(선택)
문서 에디터	OpenCode 내장 뷰어, Obsidian(옵시디언), VS Code

👤 작성자 및 라이선스 안내

작성자: JeongGooi Lee (gilson0516@gmail.com)
블로그 저장소: 오픈코드 탐구기 시리즈
라이선스: 본 가이드의 모든 내용은 자유롭게 참고 및 공유하실 수 있습니다. (MIT License)

Last Updated: 2026-11-09