월급 외 100만 원 더 버는 'Claude AI' 주식 자동매매 봇 만들기 (무작정 따라하기)"

6월 20, 2026

안녕하세요! 오늘은 최근 글로벌 트레이더들 사이에서 뜨거운 반응을 얻고 있는 Claude Code와 Interactive Brokers(IBKR) API를 결합한 AI 자동매매 시스템 구축 방법을 완전 정복해 보겠습니다. 코딩 지식이 전혀 없어도 Claude의 도움을 받아 나만의 강력한 트레이딩 봇을 만들 수 있는 단계별 가이드입니다.

1. 왜 Claude + IBKR 조합인가?

강력한 AI 코딩 (Claude): 복잡한 금융 데이터 처리 및 주문 로직을 자연어 명령만으로 완벽한 파이썬 코드로 구현합니다.
글로벌 금융 인프라 (IBKR): 전 세계 주식, 옵션, FX 등을 가장 저렴한 수수료로 거래할 수 있는 기관급 브로커 API를 제공합니다.

2. 1단계: IBKR TWS 및 API 환경 설정

가장 먼저 Interactive Brokers의 거래 프로그램인 TWS(Trader Workstation)에서 API 연결을 활성화해야 합니다.

🛠️ 설치 및 설정 순서

TWS 또는 IB Gateway 설치: IBKR 공식 홈페이지에서 TWS 정식 버전을 다운로드하여 설치합니다. (실전 매매 전 반드시 Paper Trading(모의투자) 계정으로 로그인하세요.)
API 메뉴 이동: TWS 상단 메뉴에서 File > Global Configuration으로 이동합니다.
API 설정 변경:
- API > Settings 메뉴를 클릭합니다.
- "Enable ActiveX and Socket Clients" 항목을 체크하여 활성화합니다.
- Socket Port 번호를 확인합니다. (기본값: 라이브 계정 7496, 모의투자 계정 7497)
- 보안을 위해 "Read-Only API"는 체크 해제합니다(봇이 주문을 넣어야 하기 때문입니다).

3. 2단계: 개발 환경 구성 및 필수 라이브러리 설치

봇이 구동될 컴퓨터(PC, Mac 또는 WSL 환경)에 파이썬과 필수 패키지를 설치합니다. 터미널이나 명령 프롬프트에서 아래 명령어를 실행하세요.

# 필수 파이썬 라이브러리 설치
pip install ib_insync pandas requests python-telegram-bot

※ ib_insync 라이브러리는 IBKR의 복잡한 공식 API를 파이썬에서 비동기 방식으로 아주 쉽게 다룰 수 있도록 도와주는 핵심 라이브러리입니다.

4. 3단계: 전략 수립 및 규칙 정의 (rules.json)

봇이 감정에 휘둘리지 않고 철저하게 규칙 기반으로 매매할 수 있도록 하려면, 매수/매도 및 리스크 관리 기준을 구조화된 rules.json 파일로 관리해야 합니다. Claude에게 원하는 조건을 한글로 말하고 JSON 구조 파일 생성을 요청하세요.

{
  "strategy_name": "Gap_Up_Momentum",
  "scan_criteria": {
    "min_gap_percent": 3.0,
    "min_volume": 100000
  },
  "risk_management": {
    "max_position_size_usd": 5000,
    "stop_loss_percent": 2.0,
    "take_profit_percent": 5.0
  },
  "execution": {
    "interval_minutes": 30
  }
}

5. 4단계: 핵심 파이프라인 코드 작성 (시장 스캐너 & 자동화)

Claude에게 "TWS 7497 포트에 연결하고, rules.json 기반으로 3% 이상 갭상승한 종목을 찾아 30분마다 매수 주문을 실행하며, 텔레그램으로 알림을 보내는 파이썬 코드를 짜줘"라고 명령하면 다음과 같은 구조의 백엔드 엔진이 완성됩니다.

💡 실시간 시장 스캐너 & 루프 예시 코드

from ib_insync import *
import json
import time

# IB 연결 설정
ib = IB()
ib.connect('127.0.0.1', 7497, clientId=1)

def run_trading_bot():
    print("AI 트레이딩 봇 가동 중...")
    # 1. rules.json 로드
    with open('rules.json', 'r') as f:
        rules = json.load(f)
        
    # 2. 시장 스캐닝 및 필터링 로직 수행
    # (여기에 Claude가 생성한 조건별 필터링 및 주문 집행 코드가 결합됩니다)
    
    # 3. 텔레그램 알림 발송
    # send_telegram_message("주문 집행 완료: AAPL 10주 매수")

# 30분 주기로 실행되는 루프
while True:
    run_trading_bot()
    time.sleep(1800) # 1800초 = 30분

6. 5단계: 실시간 텔레그램(Telegram) 알림 연동

스마트폰으로 언제 어디서든 봇의 체결 현황과 계좌 상태를 모니터링할 수 있도록 텔레그램 봇 API를 연동합니다.

텔레그램 앱에서 @BotFather를 검색해 대화를 시작하고 /newbot 명령어로 봇을 생성합니다.
발급받은 HTTP API Token과 본인의 Chat ID를 복사하여 파이썬 코드의 알림 모듈 변수에 입력해 주면 실시간 브리핑을 받을 수 있습니다.

7. 🎯 전문가의 현실적인 조언 및 최적화 팁

자동화 시스템 구축은 감정을 배제한 자산 증식의 훌륭한 시작점이지만, 실전 매매 전 반드시 다음 사항을 점검해야 합니다.

백테스트와 실전의 괴리: 과거 데이터 기반의 시뮬레이션 결과는 슬리피지(체결 오차), 시장 충격 비용, 호가 공백 등으로 인해 실전에서 그대로 재현되지 않을 수 있습니다. 소액 혹은 모의투자로 반드시 검증 기간을 거치세요.
인간과 AI의 조화: 전적으로 AI에게만 맡겨두는 완벽한 방치형 매매는 매크로 시장 급변기에 위험할 수 있습니다. 시장의 거시적 흐름을 보며 위험한 경제 지표 발표 시점에는 시스템을 잠시 멈추거나 rules.json의 리스크 범위를 즉각 수정해 주는 유연함이 필요합니다.

지금 바로 가볍게 모의투자(Paper Trading) 계정으로 시작해 보고, Claude와 대화하며 나만의 전략을 끊임없이 고도화해 보시기 바랍니다!

이 블로그 검색

최신 AI 뉴스