OfficeCLI 사용법: 워드 문서 만들기부터 수정과 저장 확인까지

OfficeCLI는 워드, 엑셀, 파워포인트 파일을 명령으로 읽고 고치고 만드는 도구입니다. 터미널에 직접 명령을 입력해서 쓸 수 있고, AI 에이전트에 연결하면 “이 문장의 숫자를 바꿔 주세요” 같은 요청을 에이전트가 파일 수정 명령으로 바꿔 실행합니다.

이 글은 짧은 워드 문서 하나로 전 과정을 따라갑니다. 파일을 만들고, 원하는 문장만 고치고, 저장한 파일에도 변경이 남았는지 보는 순서입니다. 여러 문서를 자동으로 처리하는 방법은 뒤에서 이어서 다룹니다.

프로그램, 스킬, MCP는 하는 일이 다릅니다

실제로 파일을 고치는 것은 OfficeCLI 프로그램입니다. 스킬은 AI에게 이 프로그램의 사용법을 알려 주는 지침 파일이고, MCP는 AI 앱이 외부 도구를 호출하도록 연결하는 규격입니다. 그래서 스킬 문서만 내려받아서는 프로그램이 설치되지 않습니다.

세 가지 구성 요소와 설치 확인 방법

항목	OfficeCLI 프로그램	스킬	MCP
하는 일	파일을 직접 고치는 프로그램	AI에게 주는 사용법 문서	AI 앱과 도구를 잇는 규격
있는지 보는 법	officecli --version	SKILL.md 파일	officecli mcp list

스킬 파일을 지우는 일, 프로그램을 제거하는 일, MCP 등록을 해제하는 일도 각각 따로 합니다.

설치 여부 확인과 설치

터미널은 명령을 입력하는 앱입니다. Mac에서는 터미널, Windows에서는 PowerShell을 열고 아래 순서로 진행합니다.

OfficeCLI 설치 순서

1. 11. 버전 확인officecli --version
   번호가 나오면 설치된 상태
2. 22. 설치공식 안내에서 운영체제에 맞는
   방법 하나로 설치
3. 33. 터미널 새로 열기다시 버전 확인
   번호가 나오면 성공
4. 44. AI 앱 연결쓰는 앱 하나에만
   스킬이나 MCP 등록

1단계에서 command not found나 명령을 찾을 수 없다는 메시지가 나오면 프로그램이 없거나 PATH에 등록되지 않은 상태입니다. PATH는 터미널이 명령을 찾는 폴더 목록입니다. 설치한 뒤에도 같은 메시지가 나오면 터미널을 새로 열고 설치 위치를 살펴봅니다.

2단계의 공식 설치 안내는 macOS와 Linux에 설치 스크립트를, Windows에 PowerShell 스크립트를 제공합니다. Homebrew나 npm을 이미 쓰고 있다면 그 방식으로 설치해도 됩니다. 방법은 하나만 고릅니다. 설치 스크립트는 실행 파일과 함께 AI 도구의 스킬 설정도 바꿀 수 있으므로, 업무용 컴퓨터라면 회사 규정에서 설치를 허용하는지 먼저 봅니다.

이미 쓰는 코딩 에이전트에게 설치를 맡긴다면 범위를 이렇게 적습니다.

AI 앱에 연결하기

Claude Code에 스킬을 직접 넣는다면 파일 위치는 ~/.claude/skills/officecli/SKILL.md입니다. 같은 위치에 파일이 이미 있으면 백업한 뒤 바꿉니다. 아래 명령은 공식 사용법 문서를 화면에 출력할 뿐 설치까지 하지는 않습니다.

MCP로 연결한다면 쓰는 앱의 등록 명령 하나만 실행합니다.

등록한 뒤 officecli mcp list에 그 앱이 보이면 연결된 것입니다.

워드 문서를 만들고 숫자 하나 고치기

주간 업무 메모를 만들고 상담 건수를 고치는 예입니다. 빈 폴더에서 시작해야 같은 이름의 기존 파일을 덮어쓰지 않습니다. 아래는 macOS와 Linux 터미널 명령입니다.

한 줄씩 실행하고 오류가 없으면 다음 줄로 넘어갑니다. create는 파일 만들기, add는 내용 추가, view는 읽기입니다. /body는 문서 본문, paragraph는 문단이고, --prop 뒤에는 텍스트와 글자 크기 같은 속성을 적습니다.

터미널, officecli-memo 폴더

> officecli view memo.docx text

/body/p[1] 주간 업무 메모
/body/p[2] 이번 주 상담은 5건입니다.

두 문장이 보이면 문단 추가가 끝난 것입니다

처음 제목을 넣을 때 Heading1 스타일을 자동으로 추가했다는 경고가 함께 나올 수 있지만, 마지막 명령 결과에 두 문장이 보이면 문단은 제대로 들어갔습니다. 이제 두 번째 문단의 숫자를 바꾸고 저장합니다.

set은 기존 내용을 고치는 명령이고 p[2]는 두 번째 문단입니다. 경로를 따옴표로 감싸야 터미널이 대괄호를 다른 뜻으로 처리하지 않습니다. 이 예에서는 중간에 문단을 넣거나 옮기지 않았으므로 두 번째 문단 번호가 그대로입니다.

수정 뒤 결과를 보는 순서

1. 11. view text5건이 6건으로
   바뀌었는지 보기
2. 22. validate형식 검사에
   오류가 없는지 보기
3. 33. HTML 미리보기memo.html을 열어
   잘린 글자가 없는지 보기
4. 44. close 후 워드저장을 마치고 워드에서
   같은 문장인지 보기

close는 수정 내용을 디스크에 저장하고 OfficeCLI의 해당 문서 작업을 끝냅니다. 워드에서 파일을 열어 둔 상태라면 먼저 닫고 명령을 실행합니다. memo.html은 만든 시점의 미리보기라서, 내용을 다시 고치면 officecli view memo.docx html -o memo-2.html처럼 새로 만들어 엽니다.

AI 에이전트에게 같은 수정을 맡길 때는 파일명, 바꿀 문장, 바꾼 뒤 확인할 내용을 함께 적습니다.

문서 안의 경로는 순서를 바꾸면 달라집니다

/body/p[2]는 두 번째 문단, /slide[1]/shape[2]는 첫 번째 슬라이드의 두 번째 도형을 가리킵니다. 번호는 문서 안의 순서이므로, 앞에 문단을 하나 넣으면 같은 번호가 다른 문장을 가리킵니다.

맨 앞에 문단을 넣으면 바뀌는 번호

경로	문단을 넣기 전	맨 앞에 작성일을 넣은 뒤
/body/p[1]	주간 업무 메모	작성일: 10월 6일
/body/p[2]	이번 주 상담은 6건입니다.	주간 업무 메모
/body/p[3]	–	이번 주 상담은 6건입니다.

그래서 고치기 전에는 view나 get으로 지금 내용을 읽고 대상을 다시 찾습니다. 지원하는 요소는 문단 ID나 도형 ID로 지정할 수도 있습니다. 자주 쓰는 명령은 아래와 같습니다.

옵션 이름을 모르면 officecli help docx paragraph처럼 대상 형식과 요소를 넣어 도움말을 엽니다. 설치한 버전에서 쓸 수 있는 속성과 경로가 나옵니다.

미리보기와 형식 검사가 잡는 문제

OfficeCLI에는 문서를 HTML로 바꾸는 렌더링 엔진이 들어 있습니다. 렌더링은 파일 구조를 사람이 볼 수 있는 화면으로 그리는 과정입니다. 검사 명령과 미리보기는 각각 잡는 문제가 다릅니다.

검사 방법별로 잡는 문제

문제	validate구조 검사	view issues서식 문제	HTML 미리보기화면
OpenXML 규격 위반	제공	–	–
일부 서식 문제	–	제공	–
글자 잘림과 배치 어긋남	–	–	제공
틀린 금액, 날짜, 사실관계	제공하지 않음	제공하지 않음	제공하지 않음
워드에서 달라지는 글꼴과 줄바꿈	제공하지 않음	제공하지 않음	제공하지 않음

PNG 스크린샷은 화면 없이 실행하는 브라우저로 만듭니다. 그래서 문서 명령은 잘 되는 서버에서도 그 브라우저가 없으면 스크린샷만 실패합니다. 이때는 HTML을 먼저 만들어 평소 쓰는 브라우저로 엽니다.

공개 예시에서 볼 수 있는 세 가지 문서

OfficeCLI는 .docx, .xlsx, .pptx 파일을 읽고 고치고 새로 만들 수 있습니다. 아래는 프로젝트가 공개한 예시이고, 제작자는 AI 에이전트가 양식 파일이나 사람의 수작업 없이 만들었다고 설명합니다.

왼쪽 컨트롤러 그림은 여러 도형을 조합해 그린 것입니다. 내 슬라이드에 적용할 때는 제목 길이가 달라지면서 도형이 겹치지 않는지 봅니다.

열은 새 계약 금액의 성장률, 행은 순매출 유지율이고, 칸마다 두 값을 바꿨을 때의 예상 금액이 들어 있습니다. 낮은 값과 높은 값을 색으로 구분했지만, 계산식과 가정이 맞는지는 셀을 직접 계산해 봐야 압니다.

워드 예시에는 체크박스가 있습니다. 이런 양식은 모양뿐 아니라 워드에서 실제로 체크가 되는지도 눌러 봅니다.

엑셀에서는 수식 계산과 피벗 테이블도 만들 수 있습니다. 피벗 테이블은 원본 행을 지역이나 제품 같은 기준으로 묶어 합계를 보는 표입니다. 중요한 금액은 몇 개 셀을 직접 계산해 대조하고, 쓸 수 있는 함수는 설치한 버전의 도움말에서 찾습니다.

같은 양식으로 여러 문서를 만들 때

안내 메일이나 수료증처럼 이름만 바뀌는 문서는 merge로 만듭니다. 양식에 {{name}}처럼 바꿀 위치를 표시해 두고, 이름 같은 데이터를 JSON으로 넘깁니다. JSON은 이름과 값을 짝지어 적는 데이터 형식입니다.

이 명령은 양식부터 새로 만들므로, template.docx와 result.docx가 없는 빈 폴더에서 실행합니다.

터미널, merge 결과

> officecli merge template.docx result.docx --data '{"name":"김예시"}'

> officecli view result.docx text

안녕하세요, 김예시님.

양식의 {{name}}에 JSON의 값이 들어갔습니다

이름이나 설명이 길어지면 줄바꿈과 페이지 수가 달라지므로, 가장 긴 값이 들어간 결과 파일도 열어 봅니다.

큰 문서는 먼저 개요와 필요한 문장만 읽고, 고칠 요소의 속성을 확인한 뒤, 꼭 필요할 때만 내부 XML을 다룹니다. 이렇게 하면 AI에게 넘기는 문서 분량은 줄지만, 모델을 부르는 비용은 여전히 듭니다.

batch는 여러 명령을 한 번에 묶어 실행하고, dump는 기존 문서를 다시 만들 수 있는 명령 데이터로 내보냅니다. 지원하지 않는 요소가 있거나 앱마다 표시가 다를 수 있어서, 복잡한 문서는 복사본 하나를 dump로 다시 만들어 원본과 나란히 비교해 봅니다.

업무 문서에 적용하는 순서

OfficeCLI는 Apache 2.0 라이선스의 오픈소스 도구라 프로그램 사용료는 없습니다. 유료 AI 에이전트에게 작업을 맡기면 그 서비스의 요금은 따로 나갑니다. 배포 실행 파일에는 필요한 .NET 런타임이 들어 있어서 일반 설치에는 별도 개발 도구를 깔지 않습니다.

실제 업무 문서에 쓰기 전

1. 11. 버전 기록officecli --version 결과를
   작업 메모에 남기기
2. 22. 복사본으로 시험실제 문서 한 개의
   복사본을 먼저 수정
3. 33. 저장 마치기상주 모드라면
   save나 close 실행
4. 44. 받는 사람의 앱페이지 번호와
   목차까지 대조

여러 사람이 같이 쓴다면 1단계의 버전 기록이 있어야 서로 다른 오류를 비교할 수 있습니다. 3단계의 상주 모드는 문서를 메모리에 열어 둔 채 작업하는 방식이어서, 다른 앱으로 열기 전에 저장을 마쳐야 합니다. 4단계에서 목차와 페이지 번호를 갱신하는 refresh는 운영체제와 설치된 워드에 따라 처리 방식이 달라서, 받는 사람이 쓸 앱에서 열어 봅니다.

화면을 보며 직접 편집하는 앱이 필요하다면 GenOffice 소개를 함께 봅니다. OfficeCLI는 명령으로 반복 작업을 이어 붙이고 싶을 때 맞는 도구이고, 파일 한 개의 수정 결과를 확인한 뒤 적용할 문서를 늘려 가면 됩니다.

Sources

• OfficeCLI 공식 저장소와 결과 예시
• OfficeCLI 설치 안내
• OfficeCLI 사용 지침과 반복 작업 안내
• 공식 렌더링 설명
• 라이선스

3줄 요약

1. OfficeCLI는 워드, 엑셀, 파워포인트 파일을 터미널 명령으로 읽고 고치고 만드는 Apache 2.0 오픈소스 도구입니다.

2. create로 파일을 만들고 add로 문단을 넣은 뒤 set으로 '/body/p[2]' 같은 위치의 내용을 고치며, close를 실행해야 수정 내용이 파일에 저장됩니다.

3. validate는 OpenXML 구조만 검사해 금액과 날짜는 직접 대조해야 하고, AI 에이전트에 연결하려면 프로그램 설치와 별도로 스킬이나 MCP를 등록합니다.