HanX 홈

AI 앱에서 HanX 쓰기

ChatGPT, Claude, Codex에게 “이 HWP 표 합계 고쳐 줘”처럼 말로 요청하세요. 문서 처리는 내 컴퓨터에 설치한 HanX가 하므로 파일이 다른 서버에 올라가거나 저장되지 않고, 비용도 들지 않습니다.

1. HanX 설치

어느 방법이든 먼저 HanX CLI를 설치합니다. macOS 13 이상, Windows x64, Ubuntu 22.04 이상 x64를 지원합니다.

npm install -g @flover124/hanx

npm에는 Node.js 18 이상이 필요합니다. macOS·Linux에서는 brew install FLOVER124/tap/hanx도 쓸 수 있습니다. 자세한 내용은 사용 안내를 보세요.

2-A. 내 컴퓨터의 AI 도구에 연결

Claude Code

HanX 플러그인을 설치하면 연결과 사용 안내가 함께 들어옵니다.

/plugin marketplace add FLOVER124/HanX
/plugin install hanx@hanx

Codex · ChatGPT 데스크톱

HanX 플러그인을 설치하면 Codex와 ChatGPT 데스크톱의 로컬 대화에서 @HanX로 쓸 수 있습니다. macOS·Linux용입니다.

codex plugin marketplace add FLOVER124/HanX
codex plugin add hanx@hanx

codex 명령이 없으면 npm install -g @openai/codex로 먼저 설치하세요. 플러그인 없이 연결하거나 Windows에서는 codex mcp add hanx -- hanx mcp를 사용하세요.

Claude 데스크톱 등 MCP 설정 파일을 쓰는 앱

{"mcpServers":{"hanx":{"command":"hanx","args":["mcp"]}}}

hanx를 찾지 못하면 which hanx(Windows는 where hanx)로 확인한 절대 경로를 넣으세요.

2-B. ChatGPT·Claude 웹에 연결

웹·모바일 AI는 내 컴퓨터의 프로그램을 직접 실행할 수 없습니다. hanx connect가 이 컴퓨터의 HanX에 Cloudflare 무료 터널로 접속 주소를 만들어 줍니다. 계정 가입이나 비용은 필요 없습니다.

1. cloudflared 설치 (처음 한 번)

   macOS	brew install cloudflared
   Windows	winget install --id Cloudflare.cloudflared
   Linux	pkg.cloudflare.com 안내대로 cloudflared 패키지 설치

2. 연결 시작

   hanx connect

   작업 폴더(기본 ~/HanX)와 https://….trycloudflare.com/mcp/… 주소가 표시됩니다. 연결하는 동안 터미널 창을 열어 두세요.

3. AI 앱에 주소 등록

   ChatGPT: 설정 → 앱(Apps & Connectors) → 고급 설정에서 개발자 모드를 켜고, 앱 만들기에서 MCP 서버 URL에 주소를 넣은 뒤 인증은 “없음”을 고릅니다. 개발자 모드 제공 여부는 요금제에 따라 다릅니다.

   Claude: 설정 → 커넥터 → 사용자 지정 커넥터 추가에서 URL에 주소를 넣습니다.

4. 문서를 작업 폴더에 넣고 요청

   예: “HanX 폴더의 매출.xlsx에 금액 열과 합계 행을 넣어서 새 파일로 저장해 줘.” 결과 파일도 작업 폴더에 저장됩니다. AI 앱에 직접 첨부한 파일은 HanX로 전달되지 않습니다.

할 수 있는 일

HanX는 언어 모델을 포함하지 않습니다. 대화는 사용하는 AI 앱이, 문서 처리는 내 컴퓨터의 HanX가 맡습니다.