이음오피스(IeumOffice): 워드·엑셀·파워포인트·PDF·한글(HWP)·마크다운·HTML·마인드맵 파일을 한 창에서 열고 고치는 무료 오픈소스 데스크톱 오피스. AI는 쓰는 사람의 Claude·Codex 구독으로 돌아갑니다. GenOffice(Apache-2.0)를 바탕으로 만들었습니다.
이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.
한국어 · English
이음오피스가 도움이 된다면 위의 별을 눌러 주세요. 별 하나가 이 프로그램을 더 많은 사람에게 알리는 힘이 됩니다.
이음오피스는 누구나 무료로 쓸 수 있는 오픈소스 데스크톱 오피스 프로그램입니다. 워드, 엑셀, 파워포인트, PDF, 마크다운, HTML 문서와 마인드맵을 한 창에서 열고 고칩니다. AI는 옆에서 답만 하는 것이 아니라 문서 자체를 고칩니다.
AI는 이미 쓰고 있는 Claude 또는 Codex 구독으로 돌아갑니다. API 키를 발급받을 필요가 없고, 이음오피스에 내는 돈도 없습니다. 구독이 없으면 무료 AI(OpenRouter, Google Gemini)를 연결해 쓸 수 있습니다.
이음오피스는 오픈소스 프로젝트 GenOffice를 바탕으로 고쳐 만든 프로그램입니다(라이선스와 출처 참고).
이음오피스는 고등학교 국어 교사가 자기가 읽고 쓰는 일에 쓰려고 만들기 시작한 프로그램입니다. 생각을 마인드맵으로 정리하고, 그 내용을 AI에게 넘기고, AI가 만든 결과물을 다시 한글이나 파워포인트로 옮겨 고치는 일이 여러 프로그램에 흩어져 있었습니다. 그 사이를 한 창에서 잇고, AI가 만든 결과물을 사람이 직접 고칠 수 있게 하려는 것이 출발점입니다.
이음오피스와 함께 두 프로그램을 계속 쓰고 있고, 그동안 많은 일을 이 프로그램들 덕분에 해낼 수 있었습니다. 팔지 않습니다. 오픈소스와 한글과컴퓨터가 공개한 HWP 형식 문서를 바탕으로 만들었습니다 (라이선스와 출처 참고).
만든 사람이 직접 쓴 이야기는 이음오피스를 만든 이유에 있습니다.
.docx), 엑셀(.xlsx), 파워포인트(.pptx),.xmind)을 열고 고쳐서 같은 파일로 저장합니다. 이ieumoffice), MCP 서버, 에이전트 스킬: 코딩 에이전트가 같은PDF, 한글(.hwp, .hwpx), 마크다운, HTML, 마인드맵. 파일은 내 PC에서 원래 형식 그대로
열고 저장합니다. 고친 부분만 원본 파일에 반영하므로, 손대지 않은 부분은
그대로 남습니다.
고칩니다. 무엇이 바뀌었는지 보이고, 되돌릴 수 있습니다.
바꿉니다.
편집기가 보여 주지 않는 요소도 저장할 때 지워지지 않고, 아무것도 고치지 않으면
원래 파일과 똑같이 저장됩니다. 여러 시트, 테마, 그림·PDF·마크다운 개요로
내보내기, 인쇄를 지원합니다.
"새 문서 만들기"를 시작하면 그 자료를 읽어 PPT, HTML, 마인드맵을 만듭니다. 글은
만들 문서 쪽 편집기의 AI가 씁니다. 지도와 마크다운 사이, 지도에서 PPT 뼈대로는
AI 없이도 바꿀 수 있습니다. 어떤 문서를 어떤 자료로 만들었는지는 파일 메뉴의
"자료 보기"에서 볼 수 있고, 이 기록은 내 PC에만 남습니다.
만들어집니다.
파일을 읽고 만들고 고칠 수 있습니다.
배포하는 운영체제는 Windows이고, Mac용 베타(Apple Silicon과 Intel)와 Linux(64비트 x64)용 베타가 따로 있습니다. Mac판과 Linux판은 개발자가 직접 확인하지 못했습니다. 문제가 있으면 이슈로 알려 주세요.
이음오피스는 어디에도 대신 로그인하지 않습니다. 내 PC에 설치되어 있고 내가 이미 로그인해 둔 Claude Code 또는 Codex 프로그램을 실행해서, 요청을 넘기고 답을 받아 옵니다. 필요한 것은 두 가지입니다.
첫 실행 안내 화면과 설정 → AI → 구독 연결에 프로그램별 상태가 보이고, 빠진 단계에 맞는 버튼이 나옵니다.
irm https://claude.ai/install.ps1 | iexwinget install OpenAI.Codexclaude auth login,실행됩니다. 앱이 설치 파일을 직접 내려받지 않습니다.
codex login)이 실행됩니다. 이때 열리는 로그인 화면은 Anthropic 또는 OpenAI의
것이고, 이 앱의 화면이 아닙니다.
사용할 AI를 "자동"으로 두면 Claude가 연결되어 있을 때 Claude를, 아니면 Codex를 씁니다. 같은 자리나 AI 창의 모델 선택에서 직접 고를 수도 있습니다. Claude Code는 2.1.248 이상이어야 하고, 그보다 낮으면 "업데이트 필요"로 표시됩니다.
첫 실행 안내 화면과 설정 → AI → 무료로 쓰기에서 무료 AI를 연결할 수 있습니다.
가입하거나 로그인한 뒤 허용을 누르면 끝납니다. 키를 복사할 필요가 없습니다. 무료 모델만 쓰고, 오늘 남은 무료 요청 수가 카드에 보입니다. 붙여넣은 뒤 연결을 누릅니다. 18세 이상만 쓸 수 있습니다. 결제가 연결된 Google 프로젝트의 키는 요금이 나갈 수 있습니다.
연결을 마치면 그 AI가 바로 사용할 AI가 됩니다. 무료 AI는 구독 모델보다 약하고 하루에 쓸 수 있는 양에 한도가 있습니다(문서를 한 번 고칠 때 요청이 여러 번 쓰입니다). 다 쓰면 그 사실과 다시 쓸 수 있는 시각을 알려 줍니다. 무료로 쓰는 동안 보낸 내용은 그 회사의 AI 개선에 쓰일 수 있으니, 개인정보가 담긴 문서는 주의하세요.
구독 프로그램은 "두뇌" 역할만 합니다. 문서를 고치고, 바뀐 내용을 보여 주고, 되돌리는 일은 앱이 합니다. 프로그램은 빈 임시 폴더에서 자체 도구를 모두 끈 채로 실행되고, Claude가 쓸 수 있는 도구가 하나라도 남아 있다고 알려 오면 그 실행은 거부됩니다.
~/.codex/auth.json, Claude의 로그인 저장소, 세션 토큰 모두 해당합니다.
회사의 프로그램과 그 회사의 화면에서 끝납니다.
사용량은 Anthropic 또는 OpenAI가 사용자 본인 계정에 매깁니다.
시작됩니다.
이음오피스 자체는 무료입니다. AI에 드는 돈은 어떤 연결을 쓰느냐에 따라 다릅니다.
| 연결 | 비용 | 언제 쓰이나 | ||
|---|---|---|---|---|
| 구독으로 로그인된 Claude 또는 Codex | 구독료 말고는 없습니다. 요청은 구독의 사용 한도에서 차감됩니다 | 기본값("자동") | ||
| 쓴 만큼 요금이 나가는 방식(API 키, 종량제 계정)으로 로그인된 Claude 또는 Codex | 쓴 만큼 그 회사에 냅니다 | 경고를 읽고 그래도 사용을 고른 뒤에만 | ||
| 설정 → AI → 고급에서 넣은 API 키 제공업체 | 쓴 만큼 그 회사에 냅니다 | 사용할 AI에서 직접 골라 둔 동안에만 | ||
| 설정 → AI → 무료로 쓰기에서 연결한 OpenRouter·Gemini | 무료 한도 안에서는 없습니다 | 연결한 뒤, 또는 사용할 AI에서 직접 골라 둔 동안 |
앱은 AI 대화를 요금이 나가는 연결로 스스로 바꾸지 않습니다. 구독 한도가 다 찼거나 로그인이 만료되면 그 요청은 멈추고 이유를 알려 줍니다(프로그램이 알려 줄 때는 한도가 풀리는 시각도 함께). 다른 구독이 연결되어 있으면 그쪽으로 이어 가는 버튼이 나오고, 저절로 바뀌지는 않습니다. 사용 한도의 80%를 넘으면 AI 창에 사용률과 초기화 시각이 표시됩니다.
Codex를 고르기 전에 알아 둘 것이 하나 있습니다. **앱에서 Codex 구독을 쓰는 것은 OpenAI가 공식 권장하는 방식이 아닙니다.** 구독을 이런 식으로 써도 되는지, 어디까지 되는지는 사용자와 Anthropic 또는 OpenAI 사이의 약관이 정하고, 그 약관은 바뀔 수 있습니다.
이미지 제공업체의 키를 넣어야 동작합니다. Codex 구독으로 이미지를 만드는 기능은 들어 있지 않습니다. 이미지 제공업체가 없으면 슬라이드는 검색으로 찾은 사진을 씁니다. 줍니다. 영상과 소리 분석은 영상 분석이 되는 키 방식 제공업체가 있어야 합니다. 무료 검색을 먼저 쓰고, 안 되면 DuckDuckGo를 씁니다. 키 방식 검색 제공업체는 고급에서 고를 수 있습니다.
설치하면 ieumoffice 명령어가 PATH에 등록됩니다(설치 뒤 터미널을 새로 여세요).
창을 띄우지 않고 같은 종류의 파일을 읽고, 만들고, 바꾸고, 고칩니다.
ieumoffice --version
ieumoffice info report.docx --json
ieumoffice convert report.md --to pdf
ieumoffice create --type docx --from notes.md --out notes.docx
ieumoffice docs read report.docx --range 0-9 --json
ieumoffice open report.docxieumoffice help가 모든 명령을 보여 줍니다. 전체 설명은
packages/cli/README.md(영어)에 있습니다.
ieumoffice mcp는 같은 명령들을 MCP(Model Context Protocol)에이전트에 ieumoffice 스킬을 설치해 줍니다. 터미널에서는
npx skills add pblsketch/openoffice로 설치합니다.
도구로 제공합니다. 같은 설정 화면에 바로 쓸 수 있는 예시가 있습니다. 예:
claude mcp add --transport stdio ieumoffice -- ieumoffice mcp
문서 명령은 전부 내 PC 안에서 돌아갑니다. 밖으로 무언가를 보내는 것은
search, image, media, read-url 네 가지뿐입니다. read-url은 입력한
주소를 그 사이트로 보내고, 나머지는 앱과 같은 경로를 씁니다.
이렇게 들어온 요청은 허용하기 전에는 구독을 쓰지 않습니다. 터미널 명령이나
MCP 도구 호출은 화면을 보는 사람이 아니라 프로그램이 보내는 요청입니다.
프로그램이 자동으로 구독을 쓰는 것은 Anthropic과 OpenAI 모두 권장하지 않고,
계정에 제한이 걸릴 수 있습니다. 그래서 **설정 → AI → 고급 → 자동 호출에 구독
사용**은 기본이 꺼짐입니다. 꺼져 있으면 이런 요청은 키 방식 제공업체가 있을
때 그것을 쓰고, 없으면 "쓸 수 없음"으로 답합니다. 켜 두면 한 번에 하나씩 차례로
처리하고, 시간당 한도는 없습니다. 지금 무엇이 어떤 경로로 되는지는
ieumoffice capabilities --json으로 볼 수 있습니다.
이음오피스는 GenOffice와 한 PC에 함께 설치할 수 있습니다. 자기 이름
(ieumoffice, ~/.ieumoffice)만 등록하고, GenOffice가 등록한 것은 읽거나
고치지 않습니다.
설치 파일은 릴리스 페이지에
IeumOffice-Setup-.exe라는 이름으로 올라옵니다. 64비트 Windows 10과
11용입니다. 그 페이지가 아직 비어 있다면 공개된 버전이 없는 것이니, 아래
방법으로 직접 빌드하세요.
설치 파일에는 코드 서명이 없습니다. 그래서 Windows가 "알 수 없는 게시자"라고 경고합니다. 보통 "Windows의 PC 보호" 창이 뜨고, **추가 정보 → 실행**을 눌러야 설치가 시작됩니다(문구는 Windows 버전에 따라 조금 다릅니다). 설치 파일은 반드시 이 저장소의 릴리스 페이지에서만 받으세요.
같은 릴리스 페이지에 두 가지로 올라옵니다. 둘 다 macOS 12 이상용입니다.
IeumOffice--arm64.dmgIeumOffice--x64.dmg내 Mac이 어느 쪽인지는 Apple 메뉴 → 이 Mac에 관하여의 "칩"(Apple M…) 또는 "프로세서"(Intel …) 칸에서 봅니다.
Mac판에는 Apple 개발자 서명이 없어서 처음 열 때 macOS가 "확인할 수 없다"고 경고합니다. 처음 한 번만 아래처럼 허용하면 됩니다.
차단되었습니다" 옆 그래도 열기를 누른 뒤 Mac 암호를 넣습니다.
"손상되었기 때문에 열 수 없습니다"라고 나오면 휴지통으로 옮기지 말고, 터미널에서 아래 한 줄을 실행한 뒤 다시 엽니다(인터넷에서 받은 파일에 붙는 표시를 지웁니다).
xattr -dr com.apple.quarantine /Applications/IeumOffice.appMac판에서 다른 점:
엽니다. 새 dmg를 받아 덮어 설치합니다.
Code나 Codex를 설치합니다.
claude auth login 또는 codex login을 직접 실행합니다.
같은 릴리스 페이지에 64비트(x86_64) Linux용 파일 세 가지가 올라옵니다.
IeumOffice-.AppImage: 실행 권한(chmod +x)을 주어 바로 실행하는 단일ieumofficeamd64.deb: Ubuntu·Debian 계열용 패키지입니다(sudo apt install./ieumofficeamd64.deb).ieumoffice-.x8664.rpm: Fedora·RHEL·openSUSE 계열용 패키지입니다(sudo dnf install./ieumoffice-.x8664.rpm).파일입니다.
deb와 rpm 패키지는 /opt/IeumOffice에 설치되고 /usr/bin/ieumoffice에
터미널 명령어를 연결합니다.
Linux판에서 다른 점:
AppImage만 스스로 업데이트합니다. deb·rpm으로 설치한 경우에는 새버전이 나오면 알려 주고 다운로드 페이지를 엽니다.
넣어야 할 때는 터미널에서 claude auth login 또는 codex login을 직접
실행합니다.
Windows 설치본과 Linux AppImage는 켠 직후에 한 번, 그 뒤로는 4시간마다 이
저장소의 GitHub 릴리스를 확인하고, 새 버전이 있으면 업데이트 창으로 알려 줍니다.
릴리스가 없거나, 인터넷이 안 되거나, 확인에 실패하면 아무 일도 일어나지 않고 앱은
그대로 쓸 수 있습니다. 직접 확인하려면 탭 줄 왼쪽의 메뉴(☰) → 업데이트 확인…을
누릅니다(Mac은 도움말 → 업데이트 확인…). 시험판(프리릴리스)은 설정 → 정보에서 업데이트 채널을 "베타 버전"으로
바꾼 경우에만 받습니다. Mac판과 Linux deb·rpm 설치본은 새 버전을 알려 주기만
합니다.
Node 22.12 이상(npm 10 이상)과 Rust가 필요합니다. cargo가 PATH에 있어야
합니다(엑셀 처리 프로그램을 만드는 데 씁니다).
git clone https://github.com/pblsketch/openoffice.git
cd openoffice
npm install
npm run dev # 모든 편집기와 앱 창을 개발 모드로 실행
npm run shell # 또는: 전체를 빌드한 뒤 앱 실행Windows 설치 파일을 만들려면(Windows 10/11 SDK도 필요합니다):
npm run native:build -w @genoffice/sheets
# apps/sheets/native/xlsx-engine/target/release/xlsx-sidecar.exe 를
# apps/sheets/native/xlsx-engine/target/x86_64-pc-windows-gnu/release/ 로 복사
npm run dist:win -- -- --publish never설치 파일은 apps/shell/release에 생깁니다. Mac 설치 파일은 저장소의 GitHub
Actions에서 "macOS build"를, Linux 패키지는 "Linux build"를 실행해 만듭니다(직접
만들려면 npm run build:all 뒤 Mac에서는
npm run dist:mac -w @genoffice/shell -- --publish never, Linux에서는
npm run dist:linux -w @genoffice/shell -- --publish never).
변경할 때 통과해야 하는 검사를
비롯한 자세한 내용은 CONTRIBUTING.md(영어)에, 새 버전을
내는 절차는 docs/releasing.ko.md에 있습니다.
코드 안의 패키지 이름과 환경 변수에는 아직 genoffice / GENOFFICE_가
남아 있습니다. 원본 프로젝트의 엔진 개선을 계속 쉽게 받아오려고 일부러 둔
것입니다.
content.xml만 든 파일)과 암호가 걸린 마인드맵Mac판과 Linux판은 개발자가 직접 확인하지 못하고 사용자들의 보고로 확인합니다.
스스로 업데이트하지 못합니다.
프로그램을 먼저 띄우기 때문에 첫 글자가 나오기까지 몇 초가 걸립니다(개발에 쓴
PC에서 Claude는 4초쯤).
있는 것(내 MCP 서버, 훅, 플러그인)은 끄지만, Codex는 ~/.codex/AGENTS.md를
여전히 대화에 넣고, 앱이 덮어쓰지 않는 설정은 그대로 적용됩니다. 앱이 Codex의
대화 기록 저장은 끄지만, Codex가 따로 남기는 진단 기록은 남습니다.
마찬가지입니다. 실제로 무엇이 되는지는 그 요금제가 정합니다.
프록시 환경 변수나 Windows의 프록시 설정을 따릅니다. Claude Code와 Codex는
별도의 프로그램이라 프록시 환경 변수(HTTPS_PROXY 등)만 봅니다. Windows에만
설정해 둔 프록시는 전달되지 않습니다.
검토하지 않았습니다.
가린 부분은 다른 편집기에 첨부하거나 홈에서 물을 때도 가려지지만, 워드 문서의
가리기 표시는 인식하지 못합니다. 터미널 명령어와 MCP로 읽을 때도 가리기가
적용되지 않습니다. 고치기 전까지는 다음 경우에도 가린 글이 AI에게 보일 수
있습니다. 파워포인트에서 글자 서식이 따로 없는 글을 가리면 표시 없이 저장될 수
있고, 마크다운에서 가린 부분 안의 인라인 코드는 가린 범위 밖에 저장되며,
.txt·.json으로 저장한 마크다운 문서를 마크다운 편집기로 다시 열면 그
편집기의 AI가 가린 글을 봅니다. 자세한 것은 PRIVACY.md에 있습니다.
파일은 열 수 없습니다.
확인하지 못했습니다. 그때까지 공개된 릴리스가 없었기 때문입니다.
다음 단계에서 만들 예정이고, 지금 앱에는 없습니다.
ieumoffice)에서 마인드맵 다루기파일의 테마는 그대로 둡니다)
이음오피스에는 자체 서버가 없고, 사용 통계도 보내지 않습니다. 문서는 내 PC에
남습니다. AI를 쓰면 문서 내용과 대화가 사용자 본인 계정으로 Anthropic 또는
OpenAI에 전송됩니다(API 키를 넣었다면 그 회사로). 그 내용이 AI 학습에
쓰이는지는 그 회사에 있는 내 계정 설정이 정합니다. 검색어는 기본적으로
Parallel과 DuckDuckGo로, 업데이트 확인은 GitHub로 갑니다. 편집기나 앱이
비정상으로 꺼지면 그 시각, 종류, 이유, 어느 편집기였는지와 그때의 메모리
사용량(숫자만)을 데이터 폴더의 crash-log.jsonl에 적습니다. AI 작업 중에 PC의
메모리가 바닥나도 같은 숫자를 한 줄 적습니다. 문서 내용, 파일 이름, 경로는 적지
않고 어디에도 보내지 않습니다. 전체 목록은 PRIVACY.md(영어)에 있습니다.
비공개로 알려 주세요. 행동 강령을 읽어 주세요.
이 프로그램은 여러 분의 도움으로 만들어집니다. 전체 목록은 CONTRIBUTORS.md에 있습니다.
이음오피스는 Apache License 2.0으로 배포합니다.
**이음오피스는 GenOffice를 바탕으로 만들었습니다.** GenOffice는 Genspark(Mainfunc, Inc.)가 만든 오픈소스 오피스 프로그램이고, 역시 Apache-2.0 라이선스입니다. 문서 엔진과 편집기는 그 프로젝트에서 왔습니다. 이음오피스는 AI를 연결하는 방식을 바꾸고, Genspark 서비스에 묶인 부분을 걷어내고, 제품 이름을 바꿨습니다. 원래의 저작권 고지는 그대로 두었고, 출처와 "고쳐 만든 버전"이라는 사실은 NOTICE에 적어 두었습니다.
슬라이드 디자인 템플릿은 frontend-slides(MIT 라이선스)의 디자인을 바탕으로 다시 만들었고, 템플릿 글꼴은 모두 SIL Open Font License 1.1입니다. 고지와 글꼴 목록은 NOTICE에 있습니다. 템플릿의 한글 글꼴 조합은 k-slide를 참고했습니다.
한글(HWP·HWPX) 편집기는 rhwp(MIT 라이선스)를 바탕으로 합니다. 한글과컴퓨터가 HWP 형식 문서를 공개하며 붙인 조건에 따라 다음 문구를 밝힙니다.
본 제품은 한글과컴퓨터의 한글 문서 파일(.hwp) 공개 문서를 참고하여
개발하였습니다.
이음오피스는 독립된 프로젝트입니다. Genspark / Mainfunc, Inc., Anthropic, OpenAI, Microsoft, 한글과컴퓨터, Adobe, XMind, Google과 제휴하거나 후원·보증을 받은 관계가 아닙니다. "GenOffice"와 "Genspark"라는 이름과 로고는 각 소유자의 상표이고, "Claude", "Codex", "ChatGPT"도 그렇습니다. "Microsoft", "Windows", "Word", "Excel", "PowerPoint"는 Microsoft Corporation의 상표이고, "한글", "한컴", "HWP", "HWPX"는 주식회사 한글과컴퓨터의 등록 상표이며, "XMind"는 XMind Ltd.의, "Google 드라이브"는 Google LLC의 상표입니다. 그 밖에 이 글에 나오는 제품 이름도 각 소유자의 상표입니다. 여기서는 이 프로그램이 무엇을 바탕으로 만들어졌고, 무엇과 함께 동작하며, 어떤 형식의 파일을 열 수 있는지 알리기 위해서만 그 이름을 적었습니다.
이음오피스는 무료입니다. 공식 배포처는 GitHub 릴리스와 ieumoffice.com 두 곳뿐이고, 돈을 받고 파는 곳이 있다면 공식 배포가 아닙니다.
Apache License 2.0은 누구나 고쳐서 다시 배포하는 것을 허락합니다. 다만 다시
배포할 때는 LICENSE와 NOTICE를 함께 넣고, 고친 파일에는
고쳤다는 사실을 밝혀야 합니다. 이 라이선스는 상표를 쓸 권리를 주지 않으므로
(4조, 6조), "이음오피스"·"IeumOffice"와 "GenOffice"의 이름과 로고를 자기
제품 이름처럼 쓸 수 없습니다. 이음오피스가 바탕으로 삼은 GenOffice, rhwp와
여러 오픈소스 프로젝트도 각자의 라이선스 조건을 지켜야 합니다. 목록은
NOTICE와 설치 폴더의 THIRD-PARTY-NOTICES.txt에 있습니다.
이음오피스는 Apache License 2.0의 7조, 8조에 따라 있는 그대로 제공하며, 어떤 보증도 하지 않습니다. AI가 만든 내용은 틀릴 수 있으니 확인한 뒤 쓰세요. 그 내용을 쓸 권리가 있는지 확인하는 일은 쓰는 사람의 몫입니다.
상표나 저작권 침해 신고, 라이선스에 관한 문의는 pblsketch@gmail.com으로 보내 주세요. 앱의 설정 → 정보에도 같은 주소가 있습니다.