AI가 보면서고치는 워드,엑셀, PPT
중급자용© AIKOREACLUBiOfficeAI/OfficeCLI
AI가 보면서 고치는 워드, 엑셀, PPT
AI가 워드, 엑셀, 파워포인트 파일을 명령 한 줄씩으로 읽고 고치고 새로 만들게 하고, 결과를 그림으로 그려 직접 보며 고치게 해 주는 터미널 도구예요. 오피스 프로그램이 없어도 돼요
AI에게 "분기 보고 발표 자료 만들어 줘"라고 하면 파일은 금방 나와요. 그런데 열어 보면 제목이 상자 밖으로 삐져나오고, 글상자 두 개가 겹쳐 있곤 하죠. AI는 자기가 만든 슬라이드를 한 번도 보지 못한 채 파일을 넘긴 거예요.OfficeCLI는 AI에게 워드, 엑셀, PPT를 고치는 명령과 함께 눈을 줘요. 문서를 HTML이나 PNG 그림으로 그려 AI가 보고, 넘친 곳을 찾아 다시 고치게 하죠. 프로그램 하나로 설치가 끝나고 오피스가 없어도 돌아가요. 별 3만 개를 넘겼고, 최신판 1.0.160이 2026-10-30에 나왔어요.


왼쪽은 데스크톱 앱 AionUi에서 AI가 OfficeCLI로 태양계 발표 자료를 만드는 과정의 한 장면이에요. 대화창에는 AI가 짠 작업 내용이, 오른쪽에는 만들어진 슬라이드가 보여요. 오른쪽은 같은 방식으로 만든 품질 분석 엑셀 파일을 엑셀에서 연 화면이에요. README는 이 예시들이 서식 파일이나 손 편집 없이 AI가 OfficeCLI만으로 만들었다고 적어요.이미지·설명: iOfficeAI/OfficeCLI README 움짤의 한 장면 (Apache-2.0)
눈 감고 만든 슬라이드, 보고 고친 슬라이드
Slide 1: 4분기 실적과 내년 성장 전략 보고
Shape 1 [TextBox]
Shape 2 [TextBox]: 매출 25% 증가
Shape 3 [TextBox]: 신규 시장 3곳 진출
글 내용과 순서는 다 맞아요.
제목 글자가 상자 오른쪽으로 넘침
Shape 3 이 Shape 2 를 가림
view issues 도 글자 넘침, 대체 글 없음, 수식 오류 같은 문제를 목록으로 내줘요.
제목 상자 안에 들어옴
두 상자 나란히
officecli validate 보고.pptx 로 파일 규격도 확인해요.
README에 적힌 문제와 명령을 이해하기 쉽게 저희가 지어낸 슬라이드로 그린 예시예요. 실제로 무엇을 찾고 어떻게 고칠지는 쓰는 AI 모델과 문서에 따라 달라요.
한눈에
무엇인가요
OfficeCLI는 워드(.docx), 엑셀(.xlsx), 파워포인트(.pptx)를 읽고, 고치고, 새로 만드는 명령어 도구예요. 실행 파일 하나에 필요한 것이 다 들어 있어요.문서 안 모든 요소에 주소가 있어요. 첫 슬라이드의 둘째 도형은 /slide[1]/shape[2], 본문 셋째 문단은 /body/p[3] 처럼 불러요. AI는 파일 속 복잡한 구조를 몰라도 주소로 찾아가 고쳐요.결과를 그림으로 봐요. view html 은 문서를 HTML 한 장으로, view screenshot 은 쪽마다 PNG로 그려요. watch 를 켜면 브라우저 미리보기가 명령마다 바로 새로 고쳐져요.엑셀 계산도 안에서 해요. 함수 350개가 넘게 들어 있어서 수식을 쓰면 값이 바로 계산되고, 피벗 테이블도 명령 하나로 만들어요.AI에 붙이는 길은 셋이에요. 스킬 파일, MCP 서버, 그냥 터미널 명령.
함께 쓰는 도구 · 클로드 코드 · 커서 · 윈드서프 · 깃허브 코파일럿 · 코덱스 · LM Studio · 오픈코드
이런 분께
- 보고서, 발표 자료, 엑셀 표를 AI에게 통째로 맡기고 싶은 직장인
- 같은 양식의 견적서, 계약서, 성적표를 데이터만 바꿔 수십 장씩 뽑아야 하는 분
- 서버나 자동화 흐름에서 오피스 없이 문서를 만들고 검사해야 하는 개발자
어떻게 작동하나요
1. 세 층으로 다뤄요. 처음엔 view 로 내용만 보고(1층), 필요하면 get, set, add, remove 로 요소 하나씩 고치고(2층), 그래도 안 되면 파일 속 XML을 직접 만져요(3층). 가벼운 것부터 쓰니 AI가 읽는 양도 줄어요.2. 틀리면 고칠 방법을 알려 줘요. 없는 슬라이드를 부르면 "슬라이드는 1~8까지 있어요" 같은 제안이 오류와 함께 와요. 속성 이름을 잘못 쓰면 가장 가까운 이름을 알려 줘요. AI가 사람 도움 없이 다시 시도할 수 있게 한 거예요.3. 보고 고치는 순환을 닫아요. 만들고, 그려 보고, validate 와 view issues 로 문제를 찾고, 고쳐요. 화면이 없는 서버나 도커 안에서도 그림을 그려요.4. 여러 단계는 한 번에. open 으로 문서를 메모리에 올려 두면 명령이 빨라지고, batch 는 여러 명령을 한 번에 적용하되 하나라도 실패하면 전부 되돌려요.핵심은 AI가 문서를 짐작으로 만들지 않고, 주소로 고치고 그림으로 확인한다는 거예요.
바로 쓸 수 있나요
필요한 것맥, 리눅스, 윈도우 중 하나와 터미널. AI와 쓰려면 클로드 코드, 커서 같은 에이전트나 MCP를 지원하는 도구. 오피스와 .NET은 따로 설치하지 않아도 돼요
비용저장소와 프로그램은 무료(Apache-2.0). 함께 쓰는 AI 도구 요금은 따로예요
시작하기
- AI에게 한 줄로 맡기기
AI 에이전트 대화창에 그대로 붙여 넣으면, 에이전트가 스킬 파일을 읽고 설치까지 한다고 README가 적어요.
curl -fsSL https://officecli.ai/SKILL.md - 직접 설치(맥, 리눅스)
윈도우는 README에 있는 PowerShell 설치 명령(install.ps1)을 써요. 맥에서는 brew install officecli, 어디서나 npm install -g @officecli/officecli 로도 설치돼요.
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash - AI 도구에 붙이기
실행 파일을 경로에 넣고, 찾아낸 AI 도구(클로드 코드, 커서, 윈드서프, 코파일럿 등)마다 스킬을 넣어요. MCP로 붙이려면 officecli mcp claude 처럼 도구 이름을 줘요.
officecli install - 30초 맛보기
빈 PPT를 만들고 미리보기를 띄운 뒤, 다른 터미널에서 슬라이드를 넣어 브라우저가 바뀌는지 봐요.
officecli create deck.pptx officecli watch deck.pptx officecli add deck.pptx / --type slide --prop title="Hello, World!"
분기 보고 발표 자료를 OfficeCLI로 만들고, 다 만든 뒤 view issues 로 넘치는 글자가 없는지 확인해 줘
README에 대화 예시 문장은 없어서, README의 끝에서 끝까지 예시(만들기, 확인, 고치기)를 우리말 한마디로 옮겼어요. 버튼으로 쓰고 싶다면 같은 회사의 데스크톱 앱 AionUi도 있어요.처음 쓰는 순서
officecli install설치하고 쓰는 AI 도구에 스킬 넣기officecli create 보고.pptx빈 파일부터 만들게 하기officecli watch 보고.pptx브라우저에 미리보기를 띄워 두고 지켜보기officecli view 보고.pptx issues --json넘침, 대체 글 없음 같은 문제 찾기officecli close 보고.pptx저장하고 닫은 뒤 오피스에서 열기
README의 끝에서 끝까지 예시를 처음 쓰는 순서로 묶은 예예요. AI에 연결했다면 이 명령들은 AI가 대신 쳐요.
명령 한 줄에 문서가 이렇게 바뀌어요
README의 빠른 시작, 명령표, 출력 예시를 이해하기 쉽게 저희가 우리말로 옮겨 그린 예시예요. 실제 화면과 출력은 판 번호와 문서에 따라 달라요.
명령어 전체 19개, 언제 쓰나
만들기·고치기
officecli create deck.pptx- 빈 문서 만들기(확장자로 종류 결정)
officecli add deck.pptx / --type slide- 슬라이드, 도형, 표 같은 요소 넣기
officecli set 파일 경로 --prop 속성=값- 요소의 글, 글꼴, 색, 위치 바꾸기
officecli remove · move · swap- 요소 지우기, 옮기기, 맞바꾸기
보기·찾기
officecli view 파일 outline- 뼈대만 글로 보기
officecli view 파일 html- 문서를 HTML 한 장으로 그리기
officecli view 파일 screenshot- 쪽마다 PNG 그림으로
officecli watch 파일- 명령마다 새로 고쳐지는 브라우저 미리보기
officecli query 파일 "run:contains(TODO)"- 조건에 맞는 요소 찾기
officecli get 파일 경로 --json- 요소 하나를 JSON으로
검사
officecli view 파일 issues- 글자 넘침, 대체 글 없음, 수식 오류 찾기
officecli validate 파일- 오피스 파일 규격에 맞는지 검사
여러 장·자동화
officecli merge 서식.docx 결과.docx --data '{...}'- {{빈칸}}에 데이터 채우기
officecli dump 기존.docx -o 설계도.json- 기존 문서를 다시 실행할 수 있는 JSON으로
officecli batch 새.docx --input 설계도.json- 여러 명령을 한 번에, 실패하면 전부 되돌림
officecli open · save · close- 메모리에 올려 두고 빠르게, 저장, 닫기
AI 연결
officecli install- 프로그램을 경로에 넣고, 찾은 AI 도구마다 스킬 설치
officecli mcp claude- 클로드 코드에 MCP 서버로 등록(cursor, vscode 등도 됨)
officecli help pptx set shape- 넣을 수 있는 속성 이름과 값 모양 보기
README의 명령표에서 자주 쓸 만한 것만 골랐어요. 경로 자리에는 '/slide[1]/shape[1]' 처럼 요소 주소를 넣어요. 명령마다 --json 을 붙이면 정해진 모양의 결과가 나와요. 모든 명령과 속성은 위키에 있어요.
AI 없이 터미널만으로도 돼요
다른 터미널에서 add, set, remove 를 칠 때마다 브라우저 미리보기(localhost:26315)가 바로 새로 고쳐져요.
officecli watch deck.pptx{{client}}, {{total}} 같은 빈칸을 넣어 둔 서식 파일에 값을 채워 새 파일로 저장해요. 모양이 흔들리지 않고, AI를 다시 부르지 않아도 돼요.
officecli merge invoice-template.docx out-001.docx --data '{"client":"Acme","total":"$5,200"}'비슷한 도구
OfficeCLI는 세 가지 오피스 형식을 만들고 고치는 쪽이고, 아래는 엑셀 전문, 한글 문서, 읽기 전용 변환 쪽이에요(각 README 기준).
주의할 점
- 설치 명령은 인터넷에서 받은 스크립트를 바로 실행하는 방식(curl ... | bash)이에요. officecli install 은 찾아낸 AI 도구마다 스킬 파일을 넣어 설정을 바꿔요. 업데이트도 뒤에서 저절로 확인하는데, officecli config autoUpdate false 로 끌 수 있어요.
- open 으로 문서를 메모리에 올려 둔 동안에는 디스크 저장이 늦춰져요. 다른 프로그램(엑셀, 워드, 파이썬)으로 열기 전에 officecli save 나 close 로 먼저 저장하라고 README가 적어요.
- 한글(HWP) 파일은 기본으로 다루지 않아요. README는 플러그인으로 .doc, .hwpx, PDF 내보내기를 늘릴 수 있다고 하지만, 저장소에 들어 있는 건 플러그인 규약 문서예요.
- README의 예시 문서들은 만든 쪽이 고른 결과예요. 같은 명령이라도 결과 모양은 쓰는 AI 모델과 지시에 따라 달라지니, 보내기 전에 view issues 와 직접 열어 보기로 확인하세요.
- 파일 속 XML을 직접 고치는 3층 명령(raw-set)은 문서를 깨뜨릴 수 있어요. 쓴 뒤에는 validate 로 검사하는 편이 안전해요. 라이선스는 Apache-2.0이라 다시 배포할 땐 NOTICE 파일을 함께 남겨야 해요.
더 보기
iOfficeAI가 공개했고, NOTICE 파일에는 goworm이 만들고 관리한다고 적혀 있어요. 저장소의 skills 폴더에는 투자 제안 발표, 재무 모델, 데이터 대시보드, 논문, 워드 양식처럼 문서 종류별 스킬도 따로 들어 있어요.
공식 사이트 ↗한국어 README ↗위키(명령·속성 전체) ↗따라 해 볼 예제 ↗데스크톱 앱 AionUi ↗깃허브 저장소 ↗
낯선 말
- CLI · 글자로 명령을 쳐서 쓰는 프로그램이에요. 터미널에서 돌려요
- MCP · AI가 바깥 도구를 불러 쓰게 이어 주는 표준 연결 방식이에요
- 에이전트 스킬 · AI가 특정 일을 할 때 꺼내 읽는 사용 설명서 파일이에요
- JSON · {"이름": "값"} 처럼 정해진 모양으로 데이터를 적는 형식이에요. 프로그램끼리 주고받기 편해요
- 렌더링 · 파일 속 정보를 사람이 보는 화면 모양으로 그려 내는 일이에요
- XML · 워드, 엑셀, PPT 파일 속에 들어 있는 태그로 된 원본 글이에요
댓글
AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.

