OfficeCLI 정리: AI 에이전트용 오피스 도구 설치와 기능

OfficeCLI는 AI 에이전트가 워드, 엑셀, 파워포인트 파일을 명령줄로 읽고 고치고 만들도록 설계된 오픈소스 도구입니다. 오피스 프로그램을 설치하지 않아도 되고, 실행 파일 하나만 내려받으면 macOS와 리눅스, 윈도우에서 동작합니다. 라이선스는 Apache 2.0입니다.

문서 작업을 AI에 맡기려는 시도는 이전에도 있었습니다. 다만 대부분은 사람이 쓰는 프로그램을 그대로 두고 그 위에 기능을 얹는 방식이었습니다. OfficeCLI는 출발점이 다릅니다. 사람이 아니라 에이전트가 쓸 것을 전제로 명령 체계와 출력 형식을 짰습니다. 이 글에서는 저장소와 공식 문서를 근거로 무엇을 할 수 있는지, 클로드 코드에 어떻게 붙이는지, 설계에서 눈여겨볼 지점은 무엇인지 정리하겠습니다.

OfficeCLI가 다루는 파일 형식과 명령 체계

지원 형식은 세 가지이고 셋 다 읽기와 수정, 새로 만들기를 모두 지원합니다.

형식	읽기	수정	새로 만들기
워드(.docx)	지원	지원	지원
엑셀(.xlsx)	지원	지원	지원
파워포인트(.pptx)	지원	지원	지원

명령은 문서를 하나의 구조로 보고 그 안의 요소를 지목하는 방식입니다. 파워포인트 파일을 만들고 슬라이드를 넣는 과정은 다음과 같습니다.

officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli add deck.pptx '/slide[1]' --type shape \
  --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
  --prop font=Arial --prop size=24 --prop color=FFFFFF

/slide[1]/shape[2] 같은 경로로 요소를 지목합니다. 파일 안쪽의 XML 구조를 몰라도 위치만 알면 해당 요소를 고칠 수 있습니다. 이 방식이 에이전트에 유리한 이유는 경로가 문서 안에서 변하지 않기 때문입니다. 읽을 때 확인한 위치를 고칠 때 그대로 쓸 수 있습니다.

주요 명령은 열다섯 개 남짓입니다. 자주 쓰이는 것만 정리하면 다음과 같습니다.

view: 개요, 텍스트, HTML, 스크린샷 등 원하는 형태로 내용을 봅니다.
query: CSS 선택자와 비슷한 문법으로 요소를 찾습니다.
batch: 여러 작업을 JSON 배열로 묶어 한 번에 실행합니다.
merge: 양식 파일의 {{key}} 자리에 JSON 데이터를 채워 넣습니다.
dump: 기존 문서를 다시 실행할 수 있는 JSON으로 바꿉니다.
validate: OpenXML 규격에 맞는지 검사합니다.
watch: 브라우저에서 미리보기를 띄우고 변경 사항을 바로 반영합니다.

클로드 코드에 OfficeCLI를 설치하는 세 가지 방법

저장소가 안내하는 방법은 세 가지입니다. 목적에 따라 고르면 됩니다.

첫째, 설치 스크립트를 실행하는 방법입니다. 실행 파일을 PATH에 넣고, 컴퓨터에 설치된 AI 코딩 도구를 찾아 스킬 파일까지 함께 넣습니다. 저장소 설명 기준으로 클로드 코드, 커서, 윈드서프, 깃허브 코파일럿을 인식합니다.

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

윈도우는 파워셸에서 irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex를 씁니다. 홈브루(brew install officecli), 스쿱(scoop install officecli), npm(npm install -g @officecli/officecli)으로도 설치됩니다.

둘째, 에이전트 대화창에 스킬 파일 주소를 붙여 넣는 방법입니다. 에이전트가 그 파일을 읽고 설치와 사용법을 함께 익힙니다.

curl -fsSL https://officecli.ai/SKILL.md

클로드 코드에 스킬로 직접 넣으려면 파일을 스킬 디렉터리에 내려받습니다.

curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md

셋째, MCP 서버로 등록하는 방법입니다. 모델 컨텍스트 프로토콜(MCP)은 AI 도구가 외부 프로그램을 붙여 쓰는 규격입니다. 명령 한 줄로 등록됩니다.

officecli mcp claude       # 클로드 코드
officecli mcp cursor       # 커서
officecli mcp vscode       # VS Code, 코파일럿
officecli mcp list         # 등록 상태 확인

렌더링 엔진을 실행 파일에 넣은 이유

OfficeCLI에서 가장 눈여겨볼 부분은 문서를 그려 내는 기능이 실행 파일 안에 들어 있다는 점입니다. 저장소는 이 엔진을 프로젝트의 핵심으로 설명합니다.

이유는 분명합니다. 문서 구조만 읽어서는 결과가 제대로 나왔는지 알 수 없습니다. 제목이 칸을 넘쳤는지, 도형 두 개가 겹쳤는지는 그려 봐야 압니다. 저장소는 시각 확인 없이 슬라이드를 만드는 에이전트가 구조는 읽어도 제목이 넘쳤는지 도형이 겹쳤는지는 판단하지 못한다고 설명합니다.

출력 방식은 세 가지입니다.

view html: 자료를 안에 담은 HTML 파일 하나로 뽑습니다.
view screenshot: 쪽마다 PNG 이미지를 만듭니다. 이미지를 읽을 수 있는 모델이 그대로 확인합니다.
watch: 로컬 서버를 띄워 브라우저에서 자동 새로고침으로 봅니다.

officecli view deck.pptx html -o /tmp/deck.html
officecli view deck.pptx screenshot -o /tmp/deck.png
officecli watch deck.pptx

렌더링이 실행 파일에 들어 있으므로 만들고, 확인하고, 고치는 순서가 화면 없는 서버나 도커 안에서도 그대로 돌아갑니다. 오피스 프로그램이나 별도 변환 도구를 붙이지 않아도 됩니다.

AI 에이전트가 만든 실제 문서 결과물

저장소에 공개된 예시입니다. 아래 문서들은 모두 에이전트가 OfficeCLI로 만든 것이고, 양식 파일이나 사람의 손질 없이 나왔다고 저장소는 설명합니다.

OfficeCLI로 만든 파워포인트 슬라이드, 왼쪽에 도형으로 그린 게임 컨트롤러와 오른쪽에 제목과 설명 문단이 배치된 어두운 배경 슬라이드

슬라이드 왼쪽의 컨트롤러 그림은 이미지 파일이 아니라 도형을 조합해 그린 것입니다. 사각형과 원, 십자 모양을 각각 배치하고 색을 넣는 방식입니다.

OfficeCLI로 만든 엑셀 민감도 분석 표, 성장률과 유지율을 가로세로 축으로 두고 각 칸의 금액이 빨강에서 초록으로 구분된 화면

엑셀 예시는 성장률과 유지율을 두 축으로 놓은 민감도 표입니다. 값이 낮은 칸은 빨강, 높은 칸은 초록으로 칠해지는 조건부 서식이 들어가 있고, 아래쪽에 시트 탭이 여러 개 보입니다. 실제 엑셀에서 열린 화면입니다.

OfficeCLI로 만든 워드 지원서 양식, 배경 조회 항목마다 체크박스가 있고 아래에 서명 동의 문단이 이어지는 문서

워드 예시는 체크박스가 들어간 지원서 양식입니다. 단순한 문단 나열이 아니라 사용자가 값을 넣도록 만든 양식 필드가 포함된 문서입니다.

엑셀 쪽에는 계산 엔진도 함께 들어 있습니다. 저장소 설명 기준으로 350개 이상의 함수를 값을 쓸 때 자동으로 계산하고, FILTER와 SORT, UNIQUE 같은 동적 배열과 XIRR, PRICE 같은 재무 함수, 통계 분포까지 다룹니다. 피벗 테이블도 원본 범위에서 명령 한 번으로 만듭니다.

토큰을 아끼도록 짜인 세 가지 장치

AI 에이전트로 문서를 만들 때 비용이 커지는 지점은 두 곳입니다. 문서 전체를 매번 읽어 들일 때와, 비슷한 문서를 처음부터 다시 만들 때입니다. OfficeCLI는 이 두 가지를 줄이는 장치를 두었습니다.

단계별 접근(L1에서 L3까지): 처음에는 읽기 전용으로 가볍게 보고, 필요할 때 구조를 다루는 단계로 올라가고, 원본 XML은 정말 필요할 때만 건드립니다. 매번 전체를 펼쳐 보지 않아 사용 토큰이 줄어듭니다.
양식 채우기(merge): 레이아웃은 한 번만 설계하고, 이후에는 {{key}} 자리에 데이터를 채웁니다. 보고서 100건을 만들 때 100번 생성하지 않으므로 결과물의 모양도 일정하게 유지됩니다.
문서 되읽기(dump): 사람이 만들어 둔 문서를 다시 실행 가능한 JSON으로 바꿉니다. 에이전트가 원본 XML 대신 정리된 명세를 읽고, 그것을 고쳐서 변형을 만듭니다.

여기에 스스로 고치는 절차도 있습니다. validate와 view issues가 문제를 잡아내고, 오류 코드에 어떤 값이 올바른지까지 함께 돌려줍니다. 에이전트가 사람에게 묻지 않고 값을 바로잡을 수 있는 구조입니다.

저장소 지표와 도입 전에 확인할 조건

2026년 8월 6일 기준으로 저장소 상태를 정리하면 다음과 같습니다.

항목	값
라이선스	Apache 2.0
스타	26,000개
포크	1,746개
열린 이슈	44개
개발 언어	C#
저장소 생성일	2026년 3월 15일
최신 릴리스	v1.0.143 (2026년 7월 28일)
최근 커밋	2026년 8월 4일

저장소를 연 지 다섯 달이 되지 않아 스타 2만 개를 넘겼고, 7월 릴리스 기록을 보면 19일, 22일, 23일, 25일, 28일로 이틀에서 사흘 간격입니다. 개발이 활발하다는 뜻이기도 하지만, 버전이 자주 바뀌므로 업무에 넣을 때는 버전을 고정해 두는 편이 안전합니다.

확인해 둘 조건도 있습니다.

파일을 다른 프로그램으로 열기 전 저장이 필요합니다. 상주 모드에서는 변경 사항이 메모리에 있다가 일정 시간 뒤 디스크에 기록되므로, 다른 도구로 읽기 전에 officecli save나 officecli close를 실행해야 합니다.
일부 기능은 운영체제를 탑니다. 목차 쪽 번호를 다시 계산하는 refresh 명령은 윈도우에서 워드를 뒷단으로 쓰고, 그 외 환경에서는 HTML 방식으로 대신 처리합니다.
소스에서 직접 빌드하려면 .NET 10 SDK가 필요합니다. 다만 배포되는 실행 파일에는 런타임이 함께 들어 있어서 쓸 때는 따로 설치하지 않아도 됩니다.
업무 문서에 바로 쓰기 전에 검증 단계를 둡니다. 오픈소스이고 활발히 고쳐지는 단계이므로, 만든 문서를 실제 오피스에서 열어 확인하는 절차를 붙이는 편이 좋습니다.

젠스파크 GenOffice와 접근 방식의 차이

같은 시기에 나온 젠스파크의 GenOffice와 비교하면 성격이 다릅니다. GenOffice는 사람이 화면을 보며 쓰는 데스크톱 앱 묶음이고, OfficeCLI는 에이전트가 명령으로 부리는 도구입니다.

구분	OfficeCLI	GenOffice
사용 주체	AI 에이전트	사람
형태	명령줄 실행 파일	데스크톱 앱
자동화 연결	스킬, MCP로 코딩 에이전트에 붙임	앱 안에서 사용
라이선스	Apache 2.0	Apache 2.0(일부 디렉터리 제외)

둘 중 하나를 고르는 문제라기보다 쓰는 상황이 다릅니다. 문서를 직접 만들고 다듬을 때는 화면이 있는 쪽이 편하고, 같은 형식의 문서를 여러 건 찍어 내거나 다른 작업 흐름 안에 문서 생성을 끼워 넣을 때는 명령줄 쪽이 맞습니다.

클로드 코드를 이미 쓰고 있다면 설치 부담은 크지 않습니다. 스킬 파일 하나를 넣는 것으로 시작할 수 있고, 맞지 않으면 파일을 지우면 됩니다. 다만 회사 문서를 다루기 전에는 만들어진 결과물을 실제 오피스에서 열어 보는 절차를 먼저 만들어 두는 편이 안전합니다.

3줄 요약

OfficeCLI는 AI 에이전트가 워드, 엑셀, 파워포인트를 명령줄로 다루도록 만든 Apache 2.0 오픈소스 도구이고, 오피스 설치 없이 실행 파일 하나로 macOS와 리눅스, 윈도우에서 동작합니다.
문서를 HTML과 PNG로 그려 내는 엔진이 실행 파일에 들어 있어서, 에이전트가 만든 결과를 직접 확인하고 고치는 순서가 화면 없는 서버에서도 돌아갑니다.
2026년 8월 6일 기준 스타 26,000개에 최신 릴리스는 v1.0.143이고 릴리스 간격이 이틀에서 사흘로 짧으므로, 업무에 넣을 때는 버전을 고정하고 결과물을 실제 오피스에서 확인하는 절차를 함께 둡니다.