chiwaa
도움말
사이트를 올리는 길은 두 가지입니다. 편한 쪽을 고르세요. 둘 다 주소는 이름.chiwaa.com 이 됩니다.
① 내 컴퓨터 폴더에서 바로 올리기 (깃허브 필요 없음)
Node.js 가 설치된 컴퓨터라면 됩니다. 사이트 폴더에서 터미널을 열고 아래를 차례로 입력하세요.
npx chiwaa login— 브라우저가 열리면 코드를 확인하고 「승인」을 누릅니다(처음 한 번만).npx chiwaa deploy— 사이트 이름을 정하면 주소가 나옵니다. 다음부터는 이 명령 한 줄이면 바뀝니다.
· package.json 에 build 가 있으면(Vite·React·Vue·Astro 등) 알아서 빌드하고 결과 폴더를 올립니다.
· 잘못 올렸으면 npx chiwaa rollback 으로 바로 전 버전으로 돌아갑니다. 남은 버전은 npx chiwaa versions.
· Claude Code·Codex·Cursor 같은 AI 도구에는 「chiwaa 에 배포해 줘. 방법은 https://chiwaa.kr/llms.txt」라고 말하면 됩니다.
· 사이트 이름은 영문 소문자·숫자·하이픈 2~30자입니다. 예: my-shop, cafe2026
CLI 명령 모음
한 번 올린 사이트 폴더에서 실행하세요. <표>·<이름>은 쓸 이름으로 바꾸고, 대괄호로 적은 부분은 생략해도 됩니다.
| 명령 | 하는 일 |
|---|---|
| 올리기·되돌리기 | |
npx chiwaa deploy [폴더] | 지금 폴더나 지정 폴더를 빌드해서 올립니다. |
npx chiwaa versions | 남아 있는 버전을 봅니다. |
npx chiwaa rollback [버전] | 바로 전 버전이나 지정 버전으로 되돌립니다. |
| 미리보기·잠금 | |
npx chiwaa deploy --preview | 운영 주소는 두고 미리보기 주소에 올립니다. |
npx chiwaa lock | 비밀번호로 사이트를 잠급니다. 비밀번호는 실행 뒤 입력합니다. |
npx chiwaa unlock | 사이트 잠금을 풉니다. |
| DB·게시판 | |
npx chiwaa db | 글 저장 상태와 표 목록을 봅니다. db status도 같습니다. |
npx chiwaa db on | 글 저장 기능을 켭니다. |
npx chiwaa db create <표> | 표를 만듭니다. --read와 --write로 읽기·쓰기 권한을 정합니다. |
npx chiwaa db rules <표> | --read와 --write로 읽기·쓰기 권한을 바꿉니다. |
npx chiwaa db rows <표> | 저장된 글을 봅니다. --page 2로 다음 쪽을 봅니다. |
npx chiwaa db code <표> | 사이트에 붙일 코드를 다시 봅니다. |
| 사진(files) | |
npx chiwaa files | 사진 목록과 용량을 봅니다. files ls도 같고 --page 2로 다음 쪽을 봅니다. |
npx chiwaa files put <사진> [사진…] | 주인 사진을 올리고 주소를 받습니다. |
npx chiwaa files on | 방문자가 사진을 올릴 수 있게 합니다. |
npx chiwaa files off | 방문자의 사진 올리기를 끕니다. |
| 서버 함수(env·logs, api/ 폴더) | |
npx chiwaa env | 서버 함수 비밀값의 이름을 봅니다. env ls도 같습니다. |
npx chiwaa env set <이름> | 비밀값을 넣습니다. 값은 실행 뒤 화면에 보이지 않게 입력합니다. |
npx chiwaa env rm <이름> | 서버 함수 비밀값을 지웁니다. |
npx chiwaa logs | 서버 함수 기록을 봅니다. --lines 100은 최근 100건, --preview는 미리보기 기록입니다. |
| 도메인 | |
npx chiwaa domains | 연결 상태와 내 x-y.net 도메인을 봅니다. domains status도 같습니다. |
npx chiwaa domains search <이름> | 살 수 있는 도메인과 1년 요금을 봅니다. |
npx chiwaa domains buy <도메인> | x-y.net 신청·결제 화면을 엽니다. 결제는 직접 합니다. |
npx chiwaa domains add <도메인> | 도메인을 붙입니다. 다른 곳에서 샀으면 연결 설정을 안내합니다. |
npx chiwaa domains check | 도메인이 연결됐는지 확인합니다. |
npx chiwaa domains remove -y | 도메인 연결을 끊습니다. 도메인 자체는 남습니다. |
| 통계·사용량·계정 | |
npx chiwaa stats | 최근 7일 방문자 통계를 봅니다. --days 30으로 기간을 바꿉니다. |
npx chiwaa usage | 요금제와 이번 달 전송량·저장 한도를 봅니다. |
npx chiwaa list | 내 사이트 목록을 봅니다. ls도 같습니다. |
npx chiwaa open | 관리 화면을 엽니다. --site를 붙이면 사이트를 엽니다. |
npx chiwaa login | 브라우저에서 승인해 로그인합니다. --token <토큰>도 됩니다. |
npx chiwaa whoami | 로그인한 계정과 요금제를 봅니다. |
npx chiwaa logout | 이 컴퓨터에 저장된 로그인 정보를 지웁니다. |
npx chiwaa agent | AI 도구용 안내를 만들거나 새로 고칩니다. 처음 올릴 때 자동으로 만듭니다. |
npx chiwaa help | 명령 도움말을 봅니다. --help와 -h도 같습니다. |
npx chiwaa --version | 설치된 명령 도구의 버전을 봅니다. -v도 같습니다. |
권한은 public(누구나), owner(주인만)입니다. 개인정보가 있는 문의 표는 --read owner로 만드세요. 사진은 먼저 npx chiwaa db on으로 글 저장 기능을 켜고 씁니다.
서버 함수는 사이트 폴더 맨 위 api/에 두고 npx chiwaa deploy로 함께 올립니다. 미리보기도 실제 사이트의 DB를 함께 씁니다.
DB 끄기·표·글·사진 지우기처럼 저장된 데이터가 사라지는 일은 CLI가 아니라 chiwaa.kr 사이트 화면의 「DB」에서 하세요.
② 깃허브 저장소 연결하기 (올릴 때마다 자동 배포)
- 로그인 — 깃허브 계정이나 x-y.net 계정으로 들어옵니다.
- 「내 사이트」에서 새 사이트를 누르고, chiwaa 가 저장소를 읽을 수 있게 깃허브에서 허용합니다.
- 저장소와 사이트 이름을 고릅니다. 빌드 설정은 저장소를 보고 정해 줍니다.
- 저장소에 파일을 올리면(push) 1분 안에 사이트가 바뀝니다. 실패하면 이전 화면이 그대로 열리고, 「왜 실패했나요」에서 한국어로 원인을 봅니다.
AI 에게 맡기기 (가장 쉬운 길)
Claude Code·Codex·Cursor 같은 AI 도구에 원하는 사이트를 말하고 끝에 「chiwaa 에 올려 줘. 방법은 https://chiwaa.kr/llms.txt」를 붙이세요. AI 가 안내를 읽고 만들기·올리기·DB·사진·결제 설정까지 합니다. 처음 한 번 브라우저에서 로그인 「승인」만 눌러 주면 됩니다.
예: 「우리 빵집 홈페이지 만들어 줘. 상품 소개, 사진 후기 게시판(비밀번호로 수정·삭제), 토스 결제까지. chiwaa 에 올려 줘. 방법은 https://chiwaa.kr/llms.txt」
DB (게시판·문의·방명록 같은 글 저장)
사이트 화면의 「DB」에서 켜고 표를 만들면, 사이트에서 /_chiwaa/data/v1/표이름 주소로 글을 저장하고 읽을 수 있습니다. 표를 만들면 붙여 넣을 코드가 함께 나옵니다. 글쓴이가 비밀번호로 자기 글을 고치고 지우는 게시판도 됩니다. Supabase 를 쓰는 사이트는 「설정값」에서 주소와 공개 키를 넣으면 됩니다.
사진 (게시판 사진 첨부·상품 사진)
「DB」 화면의 「사진」에서 방문자 사진 올리기를 켜면, 게시판 글쓰기에 사진을 붙일 수 있습니다. 올린 사진은 긴 변 2000px 로 줄이고 촬영 위치(GPS) 정보를 지운 뒤 브라우저에 맞춰 AVIF·WebP 로 보여 줍니다. 글에 쓰지 않은 방문자 사진은 하루 뒤, 글을 지우면 그 글의 사진도 지웁니다. 상품 사진은 같은 화면에서 직접 올리면 자동으로 지우지 않습니다.
서버 함수 (카카오 로그인·토스 결제·외부 API)
사이트 폴더 맨 위 api/ 에 파일을 두면 https://내사이트/api/파일이름 으로 서버에서 실행됩니다. 결제·로그인 키 같은 비밀값은 코드에 적지 않고 npx chiwaa env set 이름 으로 넣습니다(사이트 화면 「서버 함수」에서도 됩니다). 실행 기록은 npx chiwaa logs.
검증된 견본: 토스 결제 화면 · 결제 승인 · 카카오 로그인. AI 에게 「카카오 로그인 붙여 줘」라고 하면 이 견본을 씁니다. 결제 대금은 사장님 토스 계정으로 바로 들어갑니다.
안 되는 것
PHP·MySQL 사이트, 계속 돌아가는 Node 서버(Express 등), Next.js 의 서버 기능(SSR·API 라우트)은 올릴 수 없습니다. 서버에서 할 일은 위 「서버 함수」로 옮기면 됩니다. Next.js 는 output: 'export' 로 정적 내보내기를 하면 됩니다.
요금과 한도는 요금 화면에 있습니다. 더 궁금한 것은 엑스와이넷 고객센터로 물어 주세요.