코빗 CLI 사용법 총정리 — 클로드·코덱스로 코인 시세 조회부터 모의투자까지
코빗 CLI 사용법 총정리 — 클로드·코덱스로 코인 시세 조회부터 모의투자까지
이 글의 수치 기준: 코빗 공식 개발자 문서(docs.korbit.co.kr)·공식 GitHub 레포·언론 보도(2026-08-25 확인) 기반이며, 2026-08-28에는 공식 릴리스 바이너리(v1.1.0)를 직접 내려받아 API 키 없이 가능한 범위(공개 시세·dry-run 시뮬레이션)를 실제 실행해 검증했습니다(실계좌 연동·실주문은 하지 않음). 수치·기능은 각 출처의 발표 시점 기준입니다. 가상자산 투자는 원금 전액 손실 위험이 있으며, 이 글은 도구 소개일 뿐 투자 권유가 아닙니다. 전체 출처는 글 하단에 있습니다.
코빗 CLI가 무엇인가
코빗 CLI는 국내 가상자산 거래소 코빗(운영사: 디지털엑스(Digital X) — CLI 라이선스 문서 표기 기준이며, 거래소 브랜드는 현재 '코빗'을 사용)이 2026년 7월 24일 발표한 설치형 명령줄 도구입니다(공식 레포 첫 릴리스 v1.0.0은 7월 14일). 핵심은 AI 코딩 에이전트 연동: 클로드 코드(Claude Code)나 챗GPT 코덱스(Codex)에 스킬로 설치하면, "비트코인 지금 호가 보여줘" 같은 자연어 지시로 시세·잔고 조회부터 주문까지 실행됩니다.
설치는 한 줄 명령이고, 설치 후 별도 명령으로 에이전트 스킬과 MCP 서버를 구성합니다. 업비트 Skills(5월)·빗썸 AI 트레이드 킷(6월)에 이어 코빗도 합류한 국내 거래소 AI 에이전트 연동 흐름의 하나로, 국내 서비스의 AI 연동 흐름은 챗GPT·클로드에서 바로 쓰는 국내 서비스 총정리에서 함께 볼 수 있습니다.
보도자료에 없는 최신 사항 두 가지: 출시 후에도 업데이트가 이어져 2026년 8월 13일 v1.1.0이 나왔고, 코빗은 2026년 8월 24일부터 1년간 원화마켓 거래 수수료 전면 무료(전 종목·전 회원 자동 적용, 공지 기준)를 시행 중입니다.
무엇을 할 수 있나
공식 문서 기준 기능입니다.
| 기능 | 내용 |
|---|---|
| 시세 조회 | 현재가·호가·체결·캔들 (Open API v2 전 엔드포인트) |
| 주문 | 생성·취소·내역 조회 (--dry-run 미리보기 지원) |
| 잔고·계정 | 잔고, 수수료율, API 키 관리 |
| 입출금 | 조회 및 실행 (별도 권한 필요) |
| 터미널 대시보드 | korbit tui — 실시간 시세·호가·캔들 차트 |
| 실시간 모니터 | korbit monitor — WebSocket 스트리밍 |
| 모의투자 | korbit sandbox start --paper --fresh — 실시간 시세 기반 페이퍼 트레이딩 |
| MCP 서버 | korbit mcp serve — Claude Desktop 등 MCP 호스트 연결, --read-only 제한 가능 |
직접 실행해 봤다 — 키 없이 되는 것 (2026-08-28 실측)
문서만 옮기지 않기 위해 공식 릴리스(v1.1.0)를 직접 받아 실행했습니다. 공개 시세는 API 키·계정 없이 바로 나옵니다:
$ korbit ticker btc_krw
symbol last change% high low volume
btc_krw 111,677,000 2.46 111,774,000 108,800,000 20.47760265
명령은 총 68개입니다(korbit commands 첫 줄에 "68 commands"로 표시). 눈에 띄는 건 --dry-run — 주문 명령에 붙이면 전송 없이 현재 호가를 가져와 시뮬레이션만 보여줍니다:
$ korbit order place --symbol btc_krw --side buy --type limit \
--price 100000000 --qty 0.00003 --dry-run
DRY RUN — order NOT sent (public market data was fetched for the simulation/checks below)
SIMULATION (estimate only — nothing placed):
best bid / ask: 111608000 / 111674000
최소 주문 금액(5,000원) 미달 같은 문제도 이 단계에서 ⚠ [NOTIONAL_BELOW_MIN] 경고로 잡아줍니다. korbit mcp serve --help에서 --read-only가 "주문·출금·이체 쓰기 도구를 전부 제외하고 조회 도구만 노출"하는 것도 확인했습니다.
시작하는 법 — 4단계
- 설치: 터미널에서 한 줄이면 됩니다. Linux/macOS는
curl -fsSL https://docs.korbit.co.kr/install.sh | sh, Windows는 PowerShell에서irm https://docs.korbit.co.kr/install.ps1 | iex. 단일 바이너리라 Node.js 같은 런타임 설치가 필요 없습니다. - API 키 발급: developers.korbit.co.kr에서 발급합니다. 본인 인증(KYC)이 필수라 AI 에이전트가 스스로 키를 만들 수는 없습니다. 조회·주문·출금 권한이 분리돼 있으니 필요한 것만 부여하세요. 키 유효기간은 발급 후 1년입니다. 주의: IP 허용목록은 선택이 아니라 필수입니다 — 공식 FAQ 기준, 인증이 필요한 API는 "반드시 API 키마다 사전에 설정해 둔 IP 주소에서만" 이용할 수 있고(최대 20개), 유동 IP 환경이라면 고정 IP를 권장한다고 안내합니다. 일반 가정 인터넷(유동 IP)에서 IP가 바뀔 때마다 막히는 게 실사용에서 가장 먼저 부딪히는 함정입니다.
- 모의 환경에서 검증:
korbit sandbox start --paper --fresh로 실제 자산 없이 주문·체결·잔고 변화를 시험합니다. - 에이전트 연결:
korbit agent skill install로 클로드 코드·코덱스에 스킬을 설치하거나, MCP 서버로 등록합니다 — 클로드 코드는claude mcp add --transport stdio korbit -- korbit mcp serve --key <이름>, 코덱스는codex mcp add korbit -- korbit mcp serve --key <이름>(두 명령 모두 공식 레포 README·개발자센터 CLI 페이지 기준). 터미널 없이 조회·주문 검토만 하려면 릴리스에서 제공하는 Claude Desktop용.mcpb확장 파일을 쓸 수도 있습니다(공식 설명 기준 "조회와 주문 검토에 맞춘 간편 버전").
안전장치 — 확인된 것과 확인되지 않은 것
돈이 걸린 도구라 이 부분을 가장 꼼꼼히 봤습니다.
확인된 안전장치 (공식 문서 기준):
- 권한 분리: API 키 권한이 조회·주문·입출금 읽기/쓰기로 나뉘어 있고, 문서 스스로 "트레이딩 봇은 조회·주문 권한만, 출금 권한은 불필요"라며 최소 권한을 권고합니다.
- 키 발급은 사람만: 본인 인증 필수 — 에이전트가 권한을 스스로 확장할 수 없습니다.
- 주문·출금 등 자금을 옮기는 쓰기 요청은 자동 재시도되지 않습니다(공식 README 원문: "never auto-retried"). 대신 모든 주문에 멱등 ID(
clientOrderId)가 부여돼, 응답이 유실됐을 때 사용자가 같은 ID로 재시도해도 이중 주문으로 이어지지 않는 구조입니다. - 로컬 키 보관: 키는 CLI 자체 키스토어에 보관되며, 개인키는 기기를 벗어나지도 출력되지도 않습니다.
- 모의투자·미리보기: 페이퍼 트레이딩 샌드박스와
--dry-run, 시세 전용--read-only모드.
확인되지 않은 것:
- 실주문 직전 사용자에게 명시적 확인을 요구하는 절차(업비트 Skills의
CONFIRM타이핑 같은 것)는 공식 문서에서 확인되지 않았습니다. 미리보기·모의투자가 있지만, 실행 확인 관문은 업비트 쪽이 더 명시적입니다. - Open API 별도 이용료, 자산별 출금 수수료는 문서에서 언급을 찾지 못했습니다.
공식 면책 문서는 실거래 전 격리 환경 검증과 사람의 직접 코드 검토를 요구하고, 가상자산 거래가 원금 전액 손실을 포함한 중대한 시장 위험을 수반한다고 명시합니다. 손익·수수료·세무 결과는 전부 이용자 귀속입니다.
업비트 Skills와 무엇이 다른가
두 거래소 공식 문서를 직접 대조한 결과입니다. (코빗 발표 자료에 업비트 언급은 없습니다.)
| 항목 | 업비트 Skills (5/22 보도) | 코빗 CLI (7/24 발표) |
|---|---|---|
| 설치 | npm 기반, Node.js 18+ 필요 | 단일 바이너리 한 줄 설치, 런타임 불필요 |
| MCP 서버 | 공식 문서에 언급 없음 (CLI 방식) | 제공 (korbit mcp serve, --read-only 지원) |
| 실주문 확인 관문 | 주문·출금 시 CONFIRM 타이핑 필수 | 동등 절차 미확인 (--dry-run·모의투자로 대응) |
| 모의투자 | 주문 테스트 명령 | 실시간 시세 페이퍼 트레이딩 샌드박스 |
| 특이 기능 | 트래블룰 검증 보조 | TUI 대시보드, WebSocket 모니터 |
정리하면 설치 간편함과 MCP 지원, 모의투자 환경은 코빗이 앞서고, 실주문 직전의 명시적 확인 관문은 업비트가 더 뚜렷합니다.
한국 사용자 관점 메모
- 지원 대상이 코딩 에이전트(클로드 코드·코덱스) 라는 점이 중요합니다. 일반 챗GPT 앱에서 쓰는 방식은 확인되지 않았으므로, 터미널이 낯설다면 아직 대상 사용자가 아닙니다.
- 시세 알림 봇, 포트폴리오 조회 자동화처럼 돈이 움직이지 않는 용도부터 시작하는 것이 안전합니다. 이 경우 API 키에 조회 권한만 주고
--read-only로 띄우면 됩니다. - 스트리밍 봇 스크립팅 훅은 공식 문서가 실험 단계로 표시하고 있으니 자동매매 상시 운용은 아직 이릅니다.
- 개발자 문서가 AI 에이전트용
llms.txt로 한국어·영어 모두 공개돼 있어, 에이전트에 문서 주소만 넘겨도 API 사용법을 읽혀 개발을 시작할 수 있습니다.
자주 묻는 질문 (FAQ)
Q. 코빗 CLI는 무료인가요? CLI 자체는 Apache-2.0 오픈소스로 무료입니다(로컬 샌드박스 번들은 디지털엑스의 독점 소프트웨어로 별도 약관 — 공식 레포 기준). 거래 수수료는 2026년 8월 24일부터 1년간 원화마켓 전 종목 무료입니다(공지 기준, 2027년 8월 24일까지).
Q. 일반 챗GPT 앱에서도 쓸 수 있나요? 공식 지원 대상은 클로드 코드·챗GPT 코덱스 같은 AI 코딩 에이전트입니다. 일반 챗GPT 앱(커넥터) 지원은 확인되지 않았습니다. MCP 서버 모드는 Claude Desktop 등 MCP 호스트에 등록해 쓸 수 있습니다.
Q. AI가 마음대로 내 돈을 옮길 수 있는 건 아닌가요?
API 키는 본인 인증을 거쳐 사람이 직접 발급해야 하고, 조회·주문·출금 권한이 분리돼 있습니다. 공식 문서는 최소 권한을 권고합니다. 시세·잔고 조회만 쓸 경우 조회 전용 키 + --read-only 모드의 이중 차단이 안전합니다.
Q. 실거래 전에 테스트해 볼 방법이 있나요?
korbit sandbox start --paper --fresh(실시세 페이퍼 트레이딩)와 주문 --dry-run 미리보기가 있습니다. 공식 면책 문서는 실거래 전 격리 환경 검증과 사람의 직접 코드 검토를 요구합니다.
참고 출처
- 코빗 공식: korbit-cli GitHub(공식 레포, Apache-2.0) · 개발자센터 공지 "AI Agent 대응 업데이트 안내" · 개발자센터 CLI 페이지 · 개발자 문서 CLI 가이드 · API 소개·키 정책 · 공식 FAQ(IP 허용목록·요청 한도) · 면책 문서 · 릴리스(v1.1.0, 2026-08-13)
- 보도: 이투데이 — 코빗, AI 에이전트 트레이딩 '코빗 CLI' 출시(2026-07-24) · 디지털애셋 — 모의투자 환경·MCP 구성(2026-07-24) · 뉴스투데이 — 원화마켓 수수료 1년 무료(2026-08-24)
- 거래소 대조: Upbit Agent Skills 공식 문서 · 업비트 Skills 출시 보도(2026-05-22) · 빗썸 AI 트레이드 킷 공식 문서