OfficeCLI의 개요
OfficeCLI는 C#으로 작성되어 독립 실행형 단일 바이너리로 배포되는 오픈 소스 명령줄 도구로, Microsoft Office를 설치하지 않아도 AI 에이전트가 .docx, .xlsx, .pptx 파일에 경로 기반으로 접근하게 해 줍니다. 에이전트는 /slide[1]/shape[2]나 /body/p[5] 같은 요소를 지정해 텍스트나 JSON으로 읽고, 추가하거나 바꾸거나 옮기거나 지웁니다. 상위 계층으로 부족할 때는 XPath 직접 편집이 최후의 수단입니다.
자체 HTML 렌더러를 내장하고 있어 view html, view screenshot, localhost:26315의 watch 실시간 미리보기로 에이전트가 자신이 만든 결과를 볼 수 있습니다. 350개 이상의 Excel 함수를 지원하는 수식 엔진, 네이티브 피벗 테이블, {{key}} 템플릿 병합, 기존 파일을 재실행 가능한 배치 JSON으로 바꾸는 dump 명령, 하나라도 실패하면 전체를 되돌리는 원자적 배치도 있습니다. officecli install은 바이너리를 PATH에 복사하고 감지한 AI 에이전트마다 스킬을 넣습니다. officecli mcp는 Claude Code, Cursor, VS Code, LM Studio, OpenCode에 MCP 서버를 등록합니다.
AionUi를 만든 팀의 저장소로, Apache-2.0 라이선스이며 GitHub 스타는 약 33,500개입니다. v1.0.163은 2026년 11월 20일에 나왔으며, 9일 동안 세 번째 릴리스였습니다.
OfficeCLI, 쓸 만한 가치가 있습니까?
Office 작업을 맡은 에이전트는 보통 python-docx나 openpyxl로 일회용 스크립트를 쓰고, XML을 추측하며, 결과를 끝내 보지 못합니다. OfficeCLI는 이를 세 형식에 공통인 명령 세트, 요소마다 안정적인 경로, 유효한 범위를 제안하는 구조화된 오류, 그리고 멀티모달 모델이 살펴볼 수 있는 PNG로 슬라이드를 바꿔 주는 렌더러로 대체합니다. 렌더링하고, 보고, 고치는 이 반복이 진짜 핵심이며, 화면이 없는 CI나 Docker에서도 작동합니다.
기능 목록은 길고 구체적입니다. Word의 변경 내용 추적과 메모, 쓰는 순간 계산되어 get으로 결과값을 돌려주는 350개 이상의 Excel 함수, Excel에서 열면 이미 채워져 있는 피벗 테이블, PowerPoint의 모프 전환과 3D 모델 등입니다. 템플릿 병합과 dump는 실무에 맞습니다. 에이전트가 레이아웃을 한 번 설계하면, 평범한 코드가 토큰 없이 필요한 만큼 채웁니다.
주의할 점: 충실도는 프로젝트 스스로의 설명입니다. README는 렌더러를 고충실도라고 부르지만 Word, PowerPoint, LibreOffice와의 비교는 공개하지 않았습니다. 그래서 OfficeCLI의 HTML에서 제대로 보이는 슬라이드도 Office에서는 배치가 틀어질 수 있습니다. 페이지 번호 갱신은 Windows에서는 Word를, 그 밖에서는 헤드리스 HTML 대체 방식을 씁니다. 설치도 지나치게 적극적입니다. 인수 없이 officecli를 실행하면 설치가 진행되고, 찾아낸 모든 에이전트 설정에 스킬 파일을 쓰며, 매일 d.officecli.ai를 확인해 자기 바이너리를 교체합니다. 이를 막으려면 officecli config autoUpdate false를 실행하거나 Homebrew로 설치해야 합니다. 9일에 세 버전이라는 릴리스 속도 때문에 동작이 모르는 사이에 바뀝니다. README의 "세계 최초이자 최고"라는 문구는 마케팅이지 측정 결과가 아닙니다.
결론: 에이전트가 만들고 사람이 Office에서 여는 발표 자료, 보고서, 스프레드시트라면 직접 짠 스크립트보다 훨씬 낫습니다. 버전을 고정하고, 공용 머신에서는 자동 업데이트를 끄고, 고객에게 보내기 전에 실제 Office에서 열어 확인하십시오.
제 역할을 하는 곳
Claude Code를 쓰는 직원 50명 회사의 재무 분석가
CSV 내보내기 파일로 매달 이사회 보고 자료를 만들고 싶다
officecli import로 CSV를 불러오면 에이전트가 피벗 테이블과 차트를 추가하고, view screenshot으로 모든 슬라이드를 확인한 뒤 officecli merge로 해설 템플릿을 채웁니다. 무료이며, 비용은 처음 설계할 때의 에이전트 토큰이고 이후 달에는 거의 들지 않습니다.
플랫폼 엔지니어
CI 작업에서 템플릿으로 고객 계약서를 생성하고 싶다
고객마다 Docker 이미지 안에서 officecli merge contract-template.docx out.docx --data data.json을 실행하고, 업로드 전에 officecli validate를 돌립니다. 버전을 고정하고 OFFICECLI_SKIP_UPDATE=1을 설정해 빌드가 스스로 업데이트하지 않게 합니다.
법무 운영팀
수정 목록을 에이전트가 변경 내용 추적으로 반영하게 하고 싶다
에이전트가 텍스트로 단락을 찾아 각 수정을 수정자 이름과 함께 기록하므로, 변호사가 Word에서 수락하거나 거부할 수 있습니다. 보내기 전에는 view issues로 서식 문제를 찾아냅니다.
도입 전 확인할 점
- 설정
- curl로 install.sh 스크립트를 받거나 brew install officecli, scoop install officecli, npm install -g @officecli/officecli 중 하나를 실행한 뒤 officecli install을 실행합니다. 처음 쓸 만한 명령은 officecli create deck.pptx입니다. 에이전트는 https://officecli.ai/SKILL.md에서 시작할 수도 있습니다.
- 연동
- 모든 명령에서 --json을 쓸 수 있는 CLI, officecli mcp claude|cursor|vscode|lmstudio|opencode로 등록하는 MCP 서버, Claude Code, Cursor, Windsurf, GitHub Copilot, Codex용 스킬 파일, Python(officecli-sdk)과 Node.js(@officecli/sdk) SDK, .doc, .hwpx, PDF 내보내기용 플러그인. AionUi에 내장되어 있습니다.
- 데이터와 개인정보
- 파일은 로컬에서 처리됩니다. 바이너리는 매일 d.officecli.ai(대체로 GitHub)에서 업데이트를 확인하고 스스로를 교체합니다. 코드에는 메인테이너가 접속 로그에서 버전 분포를 읽는다는 설명이 있습니다. officecli config autoUpdate false나 OFFICECLI_SKIP_UPDATE=1로 끌 수 있습니다. 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 유료 버전은 없습니다. 운영 비용은 모델 토큰이며, 템플릿 병합과 배치 재실행을 쓰면 반복 문서를 모델 없이 만들 수 있습니다.
- 제한
- 상주 모드는 디스크 쓰기를 미루므로, 다른 프로그램이 파일을 읽기 전에 save나 close로 저장해야 합니다. 종료 코드 2는 부분 성공이거나 아무것도 적용되지 않았다는 뜻일 수 있어, 스크립트는 success 필드를 읽어야 합니다. PNG 스크린샷에는 헤드리스 브라우저가 필요합니다.
좋은 점
- 단일 바이너리로 Office나 런타임 없이 macOS, Linux, Windows에서 실행
- 경로 지정, JSON 출력, 구조화된 오류가 에이전트에 잘 맞음
- 내장 렌더러로 에이전트가 자기 레이아웃을 보고 고칠 수 있음
- 수식 엔진, 피벗, 템플릿 병합, 원자적 배치
아쉬운 점
- 렌더링 충실도는 자체 주장이며 Office와의 비교 공개 없음
- 기본적으로 매일 자동 업데이트하고 에이전트 설정에 스킬을 씀
- 릴리스 속도가 매우 빨라 버전마다 동작이 바뀜
- 홍보성이 강한 README가 자기 위상을 과장함
추천 대상
에이전트가 실제 Word, Excel, PowerPoint 파일을 만들거나 고쳐야 하는 팀, 특히 화면 없는 파이프라인에서 쓰는 경우.
OfficeCLI 대안
OfficeCLI: 자주 묻는 질문
- OfficeCLI, 쓸 만한 가치가 있습니까?
- 에이전트가 Office 파일 안에서 작업하는 유능하고 에이전트 친화적인 방법이지만, 충실도에 관한 주장은 믿기 전에 실제 Word와 PowerPoint에서 확인해야 합니다. 평점은 5점 만점에 4.0점입니다.
- OfficeCLI의 가격은 얼마입니까?
- 무료 오픈 소스입니다(Apache-2.0).
- OfficeCLI의 단점은 무엇입니까?
- 렌더링 충실도는 자체 주장이며 Office와의 비교 공개 없음; 기본적으로 매일 자동 업데이트하고 에이전트 설정에 스킬을 씀; 릴리스 속도가 매우 빨라 버전마다 동작이 바뀜; 홍보성이 강한 README가 자기 위상을 과장함.
- OfficeCLI에 적합한 사람은 누구입니까?
- 에이전트가 실제 Word, Excel, PowerPoint 파일을 만들거나 고쳐야 하는 팀, 특히 화면 없는 파이프라인에서 쓰는 경우.
- 팀이나 프로덕션 환경에서 OfficeCLI의 비용은 얼마입니까?
- 유료 버전은 없습니다. 운영 비용은 모델 토큰이며, 템플릿 병합과 배치 재실행을 쓰면 반복 문서를 모델 없이 만들 수 있습니다.
- OfficeCLI에 회사 데이터를 맡겨도 안전합니까?
- 파일은 로컬에서 처리됩니다. 바이너리는 매일 d.officecli.ai(대체로 GitHub)에서 업데이트를 확인하고 스스로를 교체합니다. 코드에는 메인테이너가 접속 로그에서 버전 분포를 읽는다는 설명이 있습니다. officecli config autoUpdate false나 OFFICECLI_SKIP_UPDATE=1로 끌 수 있습니다. 공개된 보안 권고는 없습니다.
- OfficeCLI의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 MarkItDown, Docling 및 AionUi입니다.
답변 확인일: 2026년 11월 20일.