코빗 CLI 사용법 총정리 — 클로드·코덱스로 코인 시세 조회부터 모의투자까지

이 글의 수치 기준: 코빗 공식 개발자 문서(docs.korbit.co.kr)·공식 GitHub 레포·언론 보도(2026-08-25 확인) 기반이며, 수치·기능은 각 출처의 발표 시점 기준입니다. 가상자산 투자는 원금 전액 손실 위험이 있으며, 이 글은 도구 소개일 뿐 투자 권유가 아닙니다. 전체 출처는 글 하단에 있습니다.

코빗 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 제한 가능

시작하는 법 — 4단계

1. 설치: 터미널에서 한 줄이면 됩니다. 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 같은 런타임 설치가 필요 없습니다.
2. API 키 발급: developers.korbit.co.kr에서 발급합니다. 본인 인증(KYC)이 필수라 AI 에이전트가 스스로 키를 만들 수는 없습니다. 조회·주문·출금 권한이 분리돼 있으니 필요한 것만 부여하고, IP 허용목록을 설정하세요. 키 유효기간은 발급 후 1년입니다.
3. 모의 환경에서 검증: korbit sandbox start --paper --fresh로 실제 자산 없이 주문·체결·잔고 변화를 시험합니다.
4. 에이전트 연결: korbit agent skill install로 클로드 코드·코덱스에 스킬을 설치하거나, korbit mcp serve --key <이름>으로 MCP 서버를 띄워 MCP 호스트에 등록합니다.

안전장치 — 확인된 것과 확인되지 않은 것

돈이 걸린 도구라 이 부분을 가장 꼼꼼히 봤습니다.

확인된 안전장치 (공식 문서 기준):

• 권한 분리: API 키 권한이 조회·주문·입출금 읽기/쓰기로 나뉘어 있고, 문서 스스로 "트레이딩 봇은 조회·주문 권한만, 출금 권한은 불필요"라며 최소 권한을 권고합니다.
• 키 발급은 사람만: 본인 인증 필수 — 에이전트가 권한을 스스로 확장할 수 없습니다.
• 출금 등 자금을 옮기는 쓰기 요청은 자동 재시도되지 않습니다. 주문은 clientOrderId로 멱등성이 보장된 경우에만 백오프 방식으로 재시도되어, 응답이 유실돼도 이중 주문으로 이어지지 않습니다(공식 문서 기준).
• 로컬 키 보관: 키는 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 사용법을 읽혀 개발을 시작할 수 있습니다.

참고 출처

• 코빗 공식: korbit-cli GitHub(공식 레포, Apache-2.0) · 개발자 문서 CLI 가이드 · API 소개·키 정책 · 면책 문서 · 릴리스(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 트레이드 킷 공식 문서