opencode-guide

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

“한컴오피스, MS 오피스, PDF 뷰어를 번갈아 띄우고 AI 창에 복사-붙여넣기 하느라 지치셨나요? 이제 한 창에서 탭으로 열고, AI가 문서 원본을 직접 고쳐주는 100% 무료 오픈소스 데스크톱 오피스를 만나보세요!”
IeumOffice 최신 버전 반영 · 2026년 11월 공식 배포 기준
현직 고등학교 국어 교사가 교육과 공익을 위해 공개한 ‘이음오피스(IeumOffice)’의 탄생 이야기와 핵심 기능, 인터넷에서 폭발적인 반응을 얻은 5대 호평 포인트, Windows/Mac/Linux 완벽 설치 가이드, 그리고 OpenCode 에이전트 연동(CLI·MCP)까지 총정리합니다.

안녕하세요. 시니어 회사원의 시선에서 AI 실무 도구를 가장 쉽고 실용적으로 해설하는 블로그의 스물한 번째 글입니다.

회사에서 업무를 보다 보면 하루에도 수십 번씩 창 전환의 늪에 빠지곤 합니다. 부처나 공공기관에서 온 아래한글(.hwp, .hwpx) 공문을 열어보고, 재무팀에서 보낸 엑셀(.xlsx) 표를 확인하며, 기획서 워드(.docx)와 발표용 파워포인트(.pptx), 그리고 참고자료 PDF까지 줄줄이 띄워놓다 보면 컴퓨터 화면은 금세 난장판이 됩니다.

여기에 AI를 활용하려 해도 번거롭기는 마찬가지였습니다. 문서 내용을 복사해서 ChatGPT나 Claude 대화창에 붙여넣고, AI가 써준 답변을 다시 문서 서식에 맞춰 붙여넣는 이른바 ‘복사-붙여넣기(복붙) 지옥’을 겪어야 했습니다. 특히 맥북(Mac)을 사용하는 직장인이라면 한컴오피스가 제대로 지원되지 않아 뷰어로 겨우 확인하거나 변환 사이트를 전전해야 했던 고통을 잘 아실 겁니다.

그런데 최근 국내 직장인과 교사, 개발자 커뮤니티를 뜨겁게 달구며 공개 며칠 만에 수천 건의 다운로드를 기록한 화제의 프로그램이 등장했습니다. 바로 현직 고등학교 국어 선생님이 직접 만들어 무료로 공개한 ‘이음오피스(IeumOffice)’입니다.

이번 글에서는 이음오피스가 왜 직장인들에게 폭발적인 지지를 받고 있는지 그 이유와 인터넷 사용자 호평 5가지, 운영체제별 설치법, 그리고 우리 블로그의 주인공인 오픈코드(OpenCode)와 MCP·CLI로 연결해 실무 생산성을 200% 끌어올리는 실전 꿀팁을 친절하게 소개해 드리겠습니다.


1. 이음오피스(IeumOffice)란? 국어 교사의 진정성에서 출발한 오픈소스

이음오피스는 충남 아산 온양여자고등학교에서 국어를 가르치시는 박준일 교사(깃허브 pblsketch)께서 자기가 읽고 쓰는 일에 쓰려고 만들기 시작한 프로그램입니다.

┌────────────────────────────────────────────────────────────────────────┐
│                        [ 이음오피스 (IeumOffice) ]                     │
├────────────────────────────────────────────────────────────────────────┤
│ • 한 창(Tab) 통합: HWP, HWPX, Word, Excel, PPT, PDF, XMind, draw.io   │
│ • 원본 파일 보존: 내 PC에서 직접 열고 고친 부분만 원래 포맷으로 저장 │
│ • 문서 내장 AI 창: 복붙 없이 AI가 표 채우기, 수식, 오탈자 원본 직접 수정 │
│ • 0원 연동: 이미 쓰던 Claude/ChatGPT 구독 또는 무료 Gemini/OpenRouter  │
│ • 무서버 로컬 보안: 회원가입 없음, 외부 서버 전송 없음, 자동 백업(.bak)│
│ • 오픈소스(Apache-2.0): GenOffice, rhwp, Univer, draw.io 등 검증된 기반│
└────────────────────────────────────────────────────────────────────────┘

선생님은 평소 수업 준비를 할 때 XMind 같은 마인드맵으로 먼저 생각을 구체화한 뒤, AI에게 의견을 묻고, 그 결과를 한글이나 파워포인트로 옮겨 활동지를 만들곤 했습니다. 그런데 이 프로그램 저 프로그램을 번갈아 옮겨 다니는 과정이 너무 번거롭다 보니 정작 가장 중요한 ‘깊이 생각하는 단계’를 자꾸 건너뛰게 되었다고 합니다.

“생각을 정리하고, AI와 대화하고, 결과물을 내 손으로 직접 고치는 과정이 너무 파편화되어 있었습니다. 그 사이를 한 창에서 잇고(이음), AI가 만든 결과물을 사람이 직접 손쉽게 고칠 수 있게 하자는 마음에서 출발했습니다.”
— 개발자 박준일 선생님의 개발기 중

이음오피스는 상용 오피스를 대체하거나 불법 복제하려는 것이 아닙니다. 이미 검증된 강력한 오픈소스 프로젝트들(문서 엔진인 GenOffice, 한글 HWP 파서인 rhwp, 스프레드시트의 Univer, 다이어그램의 draw.io)을 지혜롭게 결합하여 공익을 위해 100% 무료 오픈소스(Apache License 2.0)로 세상에 공개했습니다.


2. 이음오피스의 4대 핵심 강점

① 한 창에서 모든 문서 포맷을 탭(Tab)으로 열고 원래대로 저장

웹 브라우저에서 여러 탭을 오가듯, 이음오피스 창 하나에서 아래의 모든 문서를 열고 자유롭게 편집할 수 있습니다:

특히 중요한 점은 “원래 형식 그대로 보존”된다는 것입니다. 한글 문서를 열어 고치면 다시 한글(.hwp/.hwpx)로 깔끔하게 저장되며, 엑셀 수식이나 파워포인트 슬라이드도 제 포맷을 유지합니다.

② ‘복붙’ 없는 문서 내장형 AI 편집기

문서 편집기 바로 옆에 AI 대화창이 나란히 붙어 있습니다. AI에게 “3페이지 표에 누락된 합계 행을 추가하고 SUM 수식을 넣어줘”, “이 문단의 비문과 맞춤법을 공문서 스타일로 다듬어줘”라고 말하면, AI가 화면에 열린 문서를 직접 수정합니다. 무엇이 바뀌었는지 시각적으로 보여주는 Diff 기능을 제공하며, 마음에 들지 않으면 언제든 원클릭으로 되돌릴 수 있습니다.

③ 추가 요금 0원! 기존 AI 구독 및 무료 모델 그대로 활용

별도의 프로그램 구매 비용이나 자체 유료 구독이 전혀 없습니다.

④ 자체 서버 없는 100% 로컬 프라이버시 & 안전 백업


3. 🌐 인터넷에서 쏟아진 사용자 반응 BEST 5

이음오피스는 공개 직후 X(구 트위터), 클리앙, 뽐뿌, 긱뉴스(GeekNews), 교사 커뮤니티, 테크 블로그 등지에서 폭발적인 관심과 호평을 받았습니다. 실제 인터넷 사용자들의 반응 중 가장 공감을 얻은 5가지를 꼽아보았습니다.

┌────────────────────────────────────────────────────────────────────────┐
│                   인터넷에서 뜨겁게 호평받은 BEST 5                    │
├────────────────────────────────────────────────────────────────────────┤
│ 1. "맥북·리눅스에서 한컴 없이 HWP/HWPX를 완벽 편집하다니 눈물 납니다"  │
│ 2. "복붙 지옥 탈출! 문서 열어두고 말만 하면 표와 수식을 직접 고쳐준다"  │
│ 3. "국어 선생님의 진정성 있는 오픈소스 철학… 완전 무료에 가입도 없다"   │
│ 4. "내 문서가 외부 서버에 안 남는 100% 로컬 보안과 자동 백업의 안도감" │
│ 5. "터미널 CLI와 MCP 지원! OpenCode 등 AI 코딩 에이전트와 환상의 궁합"│
└────────────────────────────────────────────────────────────────────────┘

1) “맥북·리눅스에서 한컴오피스 없이 HWP/HWPX를 완벽 편집하다니 눈물 납니다!”

“관공서나 학교와 일할 때마다 HWP 파일 때문에 윈도우 가상머신(패러럴즈)을 켜거나 뷰어로만 겨우 보느라 스트레스가 극에 달했는데, 맥북에서 네이티브로 HWP를 열고 표까지 수정해서 다시 HWP로 저장할 수 있다니 이건 기적입니다. 맥 유저 직장인들의 오랜 한을 풀어주셨네요.”
— 맥북 사용 프리랜서 & 스타트업 실무자들의 공통된 반응

2) “복사-붙여넣기 지옥 탈출! 문서 열어두고 말만 하면 알아서 표 채우고 수정해주네요”

“기존 챗GPT 쓸 때는 ‘이 표 양식에 맞게 채워줘’ 하고 프롬프트 치고, 마크다운 표 나오면 복사해서 엑셀에 붙여넣다가 열 깨지고 난리였는데, 이음오피스는 그냥 열어둔 엑셀이나 한글 표를 AI가 직접 채워주네요. 바뀐 부분 색깔로 짚어주고 마음에 안 들면 되돌리기 되는 게 진짜 실무자 마음을 꿰뚫어 본 기능입니다.”
— 공문서 및 기획서 작성 실무자 리뷰

3) “현직 국어 교사의 진정성 있는 오픈소스 철학… 완전 무료에 가입도 없다니 감동입니다”

“요즘 AI 도구들은 들어가자마자 결제창부터 들이밀거나 회원가입, 구독 유도가 태반인데, 본인이 수업과 글쓰기에 필요해서 만든 뒤 상업적 욕심 없이 Apache-2.0 무료 오픈소스로 배포하신 국어 선생님의 이야기에 깊은 감동을 받았습니다. 이런 분이야말로 진정한 이 시대의 장인이십니다.”
— 커뮤니티(긱뉴스·클리앙) 개발자 및 교직원 댓글

4) “자체 서버 0%, 100% 로컬 저장과 백업(.bak)으로 회사 보안 걱정이 싹 사라졌습니다”

“회사 문서를 외부 클라우드 오피스에 올리면 보안 규정 위반이라 늘 불안했는데, 이음오피스는 개발자 자체 서버가 아예 없고 모든 문서가 내 PC 로컬에만 저장됩니다. 혹시 모를 파일 손상을 대비해 덮어쓸 때 .bak 원본을 남겨주는 세심한 배려까지… 회사 업무용으로 안심하고 쓸 수 있습니다.”
— 대기업/공공기관 보안 민감 직장인 후기

5) “터미널 CLI와 MCP 도구까지 완벽 지원! OpenCode 에이전트와의 결합은 환상적입니다”

“단순히 GUI 오피스 앱인 줄 알았는데 터미널 명령어 ieumoffice와 MCP 서버(ieumoffice mcp)까지 기본 내장되어 있더군요. 오픈코드(OpenCode)나 Claude Code에 MCP로 등록해두니 AI 에이전트가 내 컴퓨터의 DOCX, XLSX, HWP 파일을 자유자재로 읽고 변환해 줍니다. 개발자와 파워 유저에게는 최고의 선물입니다.”
— AI 코딩 에이전트 파워 유저 리뷰


4. [OS별] 이음오피스 다운로드 및 설치 완벽 가이드

이음오피스의 공식 배포처는 단 두 곳뿐입니다:

⚠️ 주의: 이음오피스는 100% 무료 프로그램입니다. 돈을 받고 판매하거나 비공식 다운로드 링크를 제공하는 사이트는 가짜이므로 절대 주의하세요.


[1] Windows (10 / 11 64비트) 설치 가이드

  1. 설치 파일 다운로드: 공식 사이트에서 IeumOffice-Setup-<버전>.exe를 내려받습니다.
  2. Windows 보안 경고(스마트스크린) 해결:
    • 새로 출시된 무료 오픈소스 프로그램이므로 코드 서명(수수료가 드는 상용 인증서)이 없어 Windows가 “알 수 없는 게시자” 경고를 띄웁니다.
    • 파란색 ‘Windows의 PC 보호’ 창이 뜨면 [추가 정보]를 클릭한 뒤 나타나는 [실행] 버튼을 누릅니다.
  3. 설치 마법사 진행:
    • 설치 옵션에서 ‘전용(내 이름)’ 선택 → 기본 경로 그대로 두고 [다음] → [설치] 클릭.
    • 1~2분 후 설치가 완료되면 [마침]을 눌러 이음오피스를 실행합니다.

💡 시니어 팁: 윈도우 11 ‘스마트 앱 컨트롤’로 차단될 때
일부 최신 윈도우 11 PC에서는 ‘스마트 앱 컨트롤’이 앱 실행 자체를 막을 수 있습니다. 이때는 Windows 보안 → 앱 및 브라우저 컨트롤 → 스마트 앱 컨트롤 설정에서 잠시 꺼두셔야 설치 및 실행이 가능합니다.


[2] Mac (macOS 12 이상, Apple Silicon & Intel) 설치 가이드

맥 버전은 최신 M1/M2/M3/M4 실리콘 맥과 인텔 맥 모두 지원합니다.

  1. 내 맥의 칩 종류 확인: 좌측 상단 애플 메뉴(🍎) → [이 Mac에 관하여]에서 칩이 ‘Apple M…‘인지 ‘Intel’인지 확인합니다.
  2. 맞춤형 DMG 다운로드:
    • M1 이후 실리콘 맥: IeumOffice-<버전>-arm64.dmg
    • 인텔 맥: IeumOffice-<버전>-x64.dmg
  3. 응용 프로그램 폴더로 복사: 다운로드한 .dmg 파일을 더블클릭하고, IeumOffice 아이콘을 Applications(응용 프로그램) 폴더로 드래그합니다.
  4. macOS 개발자 보안 경고 해결:
    • 처음 실행 시 “확인되지 않은 개발자” 경고가 뜨면 [완료]를 누릅니다.
    • 시스템 설정 → 개인정보 보호 및 보안으로 이동합니다.
    • 아래쪽으로 스크롤하여 “IeumOffice이(가) 차단되었습니다” 메시지 옆의 [그래도 열기] 버튼을 누르고 맥 암호(또는 Touch ID)를 입력합니다.
    • 다시 뜨는 팝업에서 [열기]를 누르면 이후부터는 경고 없이 정상 실행됩니다.

🛠️ “손상되었기 때문에 열 수 없습니다” 오류 발생 시 해결 명령어
맥 보안 격리 속성(Quarantine) 때문입니다. 터미널(Terminal)을 열고 아래 명령어를 복사해 실행하면 말끔히 해결됩니다:

xattr -dr com.apple.quarantine /Applications/IeumOffice.app

[3] Linux (AppImage, DEB, RPM) 및 서버 CLI


5. AI 모델 연결하기: 구독자 연동부터 무료 모델까지

설치를 마치고 앱을 처음 켜면 3단계의 “첫 실행 안내”가 나타납니다. 여기서 사용할 AI를 연결합니다 (나중에 설정(⚙️) → AI에서도 언제든 변경 가능).

┌────────────────────────────────────────────────────────────────────────┐
│                        [ 이음오피스 AI 연결 방식 ]                     │
├────────────────────────────────────────────────────────────────────────┤
│ 1. Claude 구독자 (Pro/Max) ──▶ Claude Code 설치 & 로그인 연동          │
│ 2. ChatGPT 구독자 (Plus 등) ─▶ 브라우저에서 OpenAI 로그인 승인 (원클릭)│
│ 3. 무료 사용자 (추천!)      ──▶ Google Gemini 키 또는 OpenRouter 연결   │
│ 4. 사내망/로컬 AI           ──▶ Ollama 등 로컬 AI 서버 주소 등록        │
└────────────────────────────────────────────────────────────────────────┘
  1. Claude 유료 구독자 (Pro / Max):
    • Claude Code 프로그램을 통해 연결됩니다. 카드에서 [설치] 및 로그인(claude auth login)을 완료하면 내 계정의 사용 한도 내에서 동작합니다.
  2. ChatGPT 유료 구독자 (Plus / Team / Pro):
    • 별도 프로그램 설치 없이 [ChatGPT로 계속] 버튼을 누르면 웹 브라우저가 열리고 OpenAI 로그인 후 권한 허용 한 번으로 연결됩니다.
  3. 구독이 없는 분들을 위한 무료 AI (강력 추천!):
    • Google Gemini: [키 만들기]를 눌러 Google AI Studio에서 무료 API 키를 발급받아 붙여넣으면 끝납니다. (Gemini 1.5 Pro/Flash의 강력한 한글 처리 성능을 무료로 체감할 수 있습니다.)
    • OpenRouter: [브라우저로 연결]을 누르면 무료 모델(Free tier)을 즉시 사용할 수 있습니다.

6. [오픈코드 파워 유저를 위한] OpenCode 에이전트 & 이음오피스 MCP·CLI 연동 노하우

이음오피스의 숨은 진가는 오픈코드(OpenCode)와 같은 AI 코딩 에이전트와 결합할 때 폭발합니다. 이음오피스는 단순한 뷰어가 아니라 내 컴퓨터에 터미널 명령어(ieumoffice)와 MCP(Model Context Protocol) 서버를 함께 설치해주기 때문입니다.

① 터미널 명령어 (ieumoffice) 단독 활용

설치 후 터미널 창을 새로 열면 어디서나 ieumoffice 명령어를 쓸 수 있습니다:

# 버전 및 상태 확인
ieumoffice --version

# 문서 구조 정보 확인 (JSON 출력)
ieumoffice info 업무보고서.docx --json

# 마크다운을 PDF 또는 DOCX로 변환
ieumoffice convert README.md --to pdf
ieumoffice create --type docx --from 회의록.md --out 회의록.docx

# 특정 범위의 본문 텍스트 읽기
ieumoffice docs read 사업계획서.docx --range 0-9 --json

# 데스크톱 이음오피스 편집기에서 바로 파일 열기
ieumoffice open 결과보고서.pptx

② 오픈코드(OpenCode)에 이음오피스 MCP 도구 등록하기

오픈코드의 대화창이나 터미널에서 다음 명령어로 ieumoffice MCP 서버를 전역 또는 프로젝트에 등록할 수 있습니다:

# OpenCode 전역 MCP 등록
opencode mcp add ieumoffice -- ieumoffice mcp

또는 프로젝트의 opencode.json 설정 파일의 mcpServers 항목에 아래와 같이 추가할 수 있습니다:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ieumoffice": {
      "command": "ieumoffice",
      "args": ["mcp"]
    }
  }
}

이제 오픈코드 에이전트는 사용자가 작성 중인 한글(HWP), 워드, 엑셀, PPT 문서를 직접 읽고, 표 구조를 분석하며, 필요한 데이터를 채워 넣는 강력한 오피스 자동화 비서로 변신합니다.


③ 오픈코드 실전 활용 프롬프트 예시

오픈코드 대화창에서 다음과 같이 자연스럽게 명령해 보세요:

ieumoffice 도구를 사용해서 현재 폴더의 '2026_예산안.xlsx' 파일의 시트 구조를 읽어줘.
합계 수식이 비어 있는 셀을 찾아서 SUM 함수를 적용해 수정해줘.
기획안.md 파일의 내용을 바탕으로 ieumoffice 명령어를 실행해
깔끔한 '신규사업_제안서.docx' 워드 문서를 생성해줘.

7. 자주 묻는 질문 (FAQ & 주의사항)

Q1. 아이패드나 갤럭시탭, 스마트폰에서도 쓸 수 있나요?

A: 아닙니다. 이음오피스는 컴퓨터 로컬 환경에서 구동되는 PC 데스크톱 전용 소프트웨어입니다. 모바일 앱이나 웹 브라우저 접속 버전은 제공되지 않습니다. (Windows 10/11, macOS, Linux 지원)

Q2. 저장할 때 원본 파일이 깨지거나 서식이 날아가지 않나요?

A: 이음오피스는 매우 엄격한 안전장치를 갖추고 있습니다. 파일을 저장할 때 먼저 임시 파일을 쓰고, 그 파일을 다시 읽어들여 화면 내용과 일치하는지 무결성을 검증한 뒤에만 원본을 덮어씁니다. 또한 한글 파일 등은 덮어쓰기 전 원본을 자동으로 .bak 백업 파일로 남겨두므로 안심할 수 있습니다. 다만, 복잡한 매크로(VBA)나 한컴 고유의 특수 개체는 한컴 한글이나 MS 오피스에서 최종 확인하는 것을 권장합니다.

Q3. 회사나 공공기관에서 업무용으로 써도 라이선스 문제가 없나요?

A: 전혀 문제없습니다. 이음오피스는 세계적으로 공인된 오픈소스 라이선스인 Apache License 2.0으로 배포됩니다. 개인은 물론 기업, 학교, 공공기관에서도 무료로 자유롭게 업무에 활용할 수 있습니다.

Q4. 회사 기밀이나 개인정보 문서를 다룰 때 AI 유출 위험은 없나요?

A: 문서 자체를 열고 편집하고 저장하는 것은 100% 사용자의 PC 로컬에서만 일어납니다. 개발자 서버로 전송되는 데이터는 일절 없습니다. 다만, AI 창에 문서를 넘겨 수정을 요청할 때는 해당 요청 내용이 Anthropic(Claude)이나 OpenAI(ChatGPT), Google(Gemini) 등의 외부 AI 서비스 제공사로 전달됩니다. 따라서 대외비 문서나 민감한 개인정보는 AI 창에 넘기지 마시고, 순수 로컬 오피스 편집 기능만 활용하시기 바랍니다.


8. 오늘 바로 해볼 실천 체크리스트


🧭 마치며: 단절된 도구를 잇고, AI와 사람이 함께 일하는 미래

이음오피스(IeumOffice)라는 이름에는 참 많은 뜻이 담겨 있습니다. 한글과 워드, 엑셀과 마인드맵처럼 서로 다른 형식의 파일들을 잇고, AI의 번뜩이는 생산성과 사람의 섬세한 손길을 한 창에서 잇겠다는 철학입니다.

코딩을 전공하지 않은 현직 국어 선생님께서 자신의 불편을 해소하기 위해 시작하여, 이제는 수많은 직장인과 연구자, 학생들의 손과 발이 되어주는 오픈소스로 성장한 이음오피스.

오늘 여러분의 컴퓨터에도 이음오피스를 설치해 보세요. 번거로운 창 전환과 복붙의 굴레에서 벗어나, 진짜 중요한 ‘나의 생각과 기획’에 집중하는 퇴근길의 여유를 누리실 수 있을 것입니다!


📚 공식 참고 자료