numbers-cli은(는) 무엇을 하나요?
Claude Code 플러그인으로, AppleScript를 통해 Apple Numbers를 완벽하게 제어할 수 있습니다 — 스프레드시트 생성, 데이터 관리, 셀 서식 지정, PDF/Excel/CSV 내보내기 지원
개요
이 플러그인은 Claude Code에서 Apple Numbers 애플리케이션을 직접 조작할 수 있는 명령어 세트를 제공합니다. AppleScript와 연동되어 Numbers 문서를 생성, 편집, 서식 지정 및 다양한 형식으로 내보낼 수 있습니다.
특징
- 새로운 Numbers 스프레드시트 생성
- 기존 문서 열기 및 수정
- 셀 데이터 읽기 및 쓰기
- 셀 서식 지정 (글꼴, 색상, 정렬, 숫자 형식 등)
- 행과 열 추가/삭제/크기 조정
- 차트 및 표 생성
- PDF, Excel (.xlsx), CSV 형식으로 내보내기
- Numbers 애플리케이션 제어 (저장, 닫기, 종료 등)
요구 사항
- 운영 체제: macOS (Apple Numbers가 설치되어 있어야 함)
- 의존성:
osascript(macOS에 내장됨) - Numbers: 버전 10 이상 권장
설치
# Claude Code 설정에 플러그인 추가
claude add-tool marcelrgberger/numbers-cli
사용법
기본 명령어
# 새 스프레드시트 생성
tell application "Numbers"
make new document
end tell
Claude Code에서 사용 예시
# "새 Numbers 문서를 만들고 첫 번째 시트에 데이터를 추가해줘"
claude "Create a new Numbers spreadsheet with column headers: Name, Email, Age"
# "이 Numbers 파일을 PDF로 내보내줘"
claude "Export /path/to/file.numbers to PDF"
지원되는 작업
| 작업 | 설명 |
|---|---|
create | 새 Numbers 문서 생성 |
open | 기존 .numbers 파일 열기 |
add_data | 특정 셀에 데이터 추가 |
read_data | 셀에서 데이터 읽기 |
format | 셀 서식 지정 (글꼴, 색상 등) |
export_pdf | PDF로 내보내기 |
export_xlsx | Excel 형식으로 내보내기 |
export_csv | CSV로 내보내기 |
구성
플러그인은 기본적으로 자동 설정되며, 추가 구성이 필요하지 않습니다. Numbers가 macOS에 설치되어 있으면 바로 사용할 수 있습니다.
문제 해결
- Numbers가 열리지 않음:
osascript -e 'tell application "Numbers" to activate'실행 - 권한 오류: 시스템 환경설정 > 보안 및 개인정보 보호 > 자동화에서 Claude Code에 Numbers 제어 권한 부여
- AppleScript 오류: Numbers 최신 버전으로 업데이트
라이선스
MIT