처음이신가요? 3단계로 시작해요
미나고는 내 글을 학습해 내 말투 그대로 대신 써주는 AI 예요. 코딩 없이도 바로 쓸 수 있어요.
- ①웹에서 바로 시작하거나(설치 없이), 데스크톱 앱을 설치해요.
- ②내 글 1~3편으로 나만의 AI 작가를 만들어요.
- ③그 작가에게 제목만 주면 새 글 한 편이 써져요.
개발자세요? 아래에서 CLI·API·MCP 같은 방식을 골라 자동화할 수 있어요.
어떤 방식으로 쓸까요?
미나고는 한 바이너리로 여섯 가지 방식을 제공해요 — 대화형 TUI(minago), 명령 한 줄 CLI, 앱 창 GUI(minago gui), AI 도구에 연결하는 MCP(minago mcp), 프로그램에서 부르는 로컬 API(minago serve), 그리고 무설치 웹. 각 방식의 가이드는 아래 카드에서 열어보고, 같은 작업의 표면별 등가물은 매트릭스에서 확인하세요.
쓰는 방식 고르기
한 작업, 여섯 진입
같은 작업을 여섯 방식에서 어떻게 부르는지 — 같은 흐름·같은 차감, 진입만 달라요.
| 작업 | CLI | TUI | GUI | MCP | API | Web | 비용 |
|---|---|---|---|---|---|---|---|
| 내 상태·사용량 | minago whoami | minago | minago gui | minago_whoami | GET /v1/whoami | /app | 무료 |
| 작가 목록 | minago agents | minago | minago gui | minago_agents_list | GET /v1/agents | /app | 무료 |
| 작가 상세 | minago agents show | minago | minago gui | minago_agent_get | GET /v1/agents/{id} | /app | 무료 |
| 작가 삭제 | minago agents rm | minago | minago gui | minago_agent_delete | DELETE /v1/agents/{id} | /app | 무료 |
| 작가 만들기 | minago generate | minago | minago gui | minago_generate | POST /v1/agents | /app | 성공 1편 |
| 대필(글쓰기) | minago write | minago | minago gui | minago_ghostwrite | POST /v1/ghostwrite | /app | 성공 1편 |
핵심 개념
인증·잉크·사용량·언어·오류 — 어떤 방식으로 쓰든 알아두면 좋은 것들만 모았어요.
작가(writer)란?
작가는 내 글 3편을 학습해 내 말투 그대로 대신 써주는 나만의 AI 예요.
- 먼저
generate(작가 만들기)로 내 글 몇 편을 학습시켜 작가를 만들어요. - 그다음
write(글쓰기)로 그 작가에게 제목만 주면 새 글 한 편을 써줘요. - 블로그별·주제별로 여러 명 만들어 골라 쓸 수 있어요.
로그인과 인증
미나고의 모든 사용량은 계정(이메일 + 비밀번호 + 2단계 인증)에 묶여요. 기기와 웹은 이 계정에 연결돼 같은 구독·사용량을 함께 써요.
| 사용 방식 | 인증 |
|---|---|
| 터미널 (CLI·TUI·API·MCP) | 기기 토큰 — 설치할 때 계정에 한 번 링크 |
| 웹 (/app) | 로그인 세션 |
- 데스크톱은 처음 한 번만 계정에 링크하면 그 뒤로는 자동이에요.
- 웹은 로그인하면 바로 같은 구독을 써요.
- 한 계정의 여러 기기와 웹이 사용량을 함께 써요.
잉크와 이용량
미나고는 잉크로 사용량을 세요. 구독 플랜마다 매달 잉크가 새로 주어지고, 한 달이 지나면 남은 잉크는 사라져요(이월 없음).
- 조회는 무료 — 상태·작가 목록·상세는 차감이 없어요.
- 글 생성만 차감 — 작가 만들기·대필이 품질을 통과해 한 번 완성될 때만 잉크가 빠져요.
- 품질 평가와 실패한 작업은 차감이 없어요 — 성공한 글은 완성에 실제로 쓰인 만큼(품질 보정 재작성 포함) 차감돼요.
- 어떤 방식으로 쓰든(CLI·웹·MCP 등) 같은 흐름·같은 차감이에요.
이용량 — 월 한도 안에서 자유롭게
구독판은 매월 받는 잉크 이용량 한도 안에서 속도 제한 없이 자유롭게 쓸 수 있어요.
- 작업 예상 비용이 이번 달 남은 이용량 안에 들면 바로 진행돼요. 모자라면 이용량이 줄지 않고 거절돼요.
- 터미널·웹에 이번 달 남은 이용량이 보여요.
- 무료 체험에도 속도 한도가 없어요.
완성한 글은 어디에?
완성한 글은 내 기기의 보관함에 자동으로 저장돼요 — 언제든 다시 열어 보거나 .md 파일로 내보낼 수 있어요.
- 터미널:
minago library(목록·open·export·rm) - 앱(GUI)·웹: 왼쪽 보관함 화면
- 데스크톱 보관함은 영구 보관, 웹(브라우저)은 30일 후 정리돼요.
언어와 결제 시장
고른 언어가 결제 시장을 정해요.
- 한국어 → 원화 결제
- English → 미국 달러 결제
쓰는 방식·차감·기능은 두 시장이 똑같아요 — 보이는 통화와 결제 수단만 달라요.
오류와 코드
문제가 생기면 미나고는 짧은 코드로 알려주고, 화면에는 그 뜻과 다음 행동을 풀어서 보여줘요.
| 코드 | 뜻 |
|---|---|
| insufficient_balance | 이번 달 잉크(이용량)가 부족해요 — 상위 월간 요금제로 변경하거나 다음 갱신일까지 기다려요 |
| bad_provider · bad_model | 없는 AI·모델을 골랐어요 — 쓸 수 있는 목록을 함께 알려줘요 |
| quality_failed | 품질 기준을 넘지 못했어요(무과금 — 자료·모델 바꿔 재시도) |
| expired | 무료 체험이 끝났어요 |
| revoked | 기기·계정이 차단됐어요 |
| transferred | 다른 기기로 이전됐어요 |
한도 초과나 실패처럼 글이 안 만들어진 경우엔 잉크가 빠지지 않아요.