macOS, Windows, Linux에서 만나는 HanX

AI 에이전트 연동이 가능한작업 도구HWP, DOCX, PDF, PPTX, XLSX, TXT

셀과 수식부터 문서와 슬라이드까지.
터미널에서 작업하고, 앱에서 확인하세요.

매출.xlsx로컬 파일 작업
fx=SUM(D2:D4)135,000
ABCD
1품목수량단가금액
2노트103,00030,000
3파일154,00060,000
4펜301,50045,000
HanX CLI$ hanx spreadsheet eval 매출.xlsx --formula '=SUM(D2:D4)'

✓ 135000

사용 예시입니다. 문서는 기기 안에서 처리합니다.

바로 시작해 보세요

앱만, CLI만, 또는 둘 다.
설치 후 원하는 구성을 선택할 수 있어요.

현재 배포 2.13.2설치 안내

macOS 13 이상 / Windows x64 / Ubuntu 22.04 이상 x64

Claude·ChatGPT 데스크톱에서 쓰기

설치한 HanX를 AI 앱에 연결하고 “이 HWP 표 합계 고쳐 줘”처럼 말로 요청하세요.
문서는 내 컴퓨터의 HanX가 처리합니다.

Claude Desktop
  1. Claude 설정 → 개발자 → 구성 편집으로 claude_desktop_config.json을 엽니다.
  2. 아래 내용을 넣어 저장하고 Claude를 다시 시작하세요. 다른 서버가 있다면 mcpServers 안에 hanx 항목만 추가합니다.
{ "mcpServers": { "hanx": { "command": "hanx", "args": ["mcp"] } } }

hanx를 찾지 못하면 command에 전체 경로를 넣으세요. Mac 앱은 /Applications/HanX.app/Contents/Resources/CLI/hanx, 그 밖에는 which hanx로 확인합니다. Windows는 "command": "cmd", "args": ["/c", "hanx", "mcp"]를 쓰세요.

ChatGPT Desktop · Codex
  1. 터미널에서 HanX 플러그인을 설치합니다. Codex와 ChatGPT 데스크톱이 같은 플러그인을 씁니다.
codex plugin marketplace add FLOVER124/HanX codex plugin add hanx@hanx
  1. ChatGPT를 다시 열고 새 로컬 대화에서 @HanX를 선택합니다.
  2. 문서 경로를 알려 주거나 파일을 선택하고 “이 HWP를 DOCX로 저장해 줘”처럼 요청하세요.

codex 명령이 없으면 npm install -g @openai/codex로 먼저 설치하세요. macOS·Linux용이며, Windows는 codex mcp add hanx -- hanx mcp로 연결합니다. 웹·모바일 ChatGPT는 hanx connect를 사용하세요.

Claude Code·Codex 플러그인과 자세한 설명은 AI 연결 안내에서 확인하세요.

반복하는 작업은 줄이고,
문서에 집중하세요

읽기, 편집, 계산, 변환을 같은 흐름으로 연결합니다.

fx

수식도, 셀 편집도
에이전트와 함께

CLI 또는 MCP로 범위를 읽고 수식을 넣으세요.
새 파일로 저장한 뒤 계산 결과를 다시 확인할 수 있습니다.

hanx spreadsheet read 매출.xlsx
--range A1:D5 --pretty
XLSXCSVTSV
Aa

파일 형식이 달라도
익숙한 작업 그대로

문서, 프레젠테이션과 XML을 다루고
필요한 형식으로 변환하세요.

HWPDOCXPDF
hanx --convert

파일을 드롭하고 출력 형식을 선택하세요.

직접 보고 다듬고 싶을 땐,
HanX 앱을 여세요

슬라이드의 그림과 동영상, 문서의 서식과 표를
화면에서 확인하고 편집할 수 있어요.

설치한 뒤에도,
최신 상태로 간편하게

npm과 Homebrew로 설치했다면
같은 명령으로 버전을 확인하고 업데이트하세요.

버전과 최신 여부 확인
hanx --version
업데이트
hanx --update
HanX 2.13.2 Up to date표시 예시

hanx --version에 표시된 번호를 입력하세요.

현재 배포 버전과 비교합니다.

이 명령은 업데이트 기능이 포함된 배포판부터 사용할 수 있습니다. 이전 버전은 npm 또는 Homebrew로 한 번 업데이트하세요. ZIP과 설치 파일로 직접 설치한 앱은 최신 다운로드로 교체할 수 있습니다.

필요한 명령부터 찾아보세요

설치, 파일 변환과 AI 에이전트 연결까지 안내합니다.

사용 안내 열기

HanX에 문의하기

사용 중 겪은 문제나 궁금한 점을 보내주세요.

[email protected]
문의하기