# Claude Code와 함께 한투 API 트레이딩 자동화를 만든 과정 - 작성자: [성실한 펭귄](https://community.clauders.ai/member/imported-member-Q4rwQWOB6m) - 공간: [비즈니스 / 재테크](https://community.clauders.ai/business) - 게시: 2026-06-01 - 연재: [에이전틱 AI 투자 시스템](https://community.clauders.ai/series/agentic-investing-systems) 2/2편 - 태그: #에이전틱AI투자 - 주소: https://community.clauders.ai/business/post/claude-code%EC%99%80-%ED%95%A8%EA%BB%98-%ED%95%9C%ED%88%AC-api-%ED%8A%B8%EB%A0%88%EC%9D%B4%EB%94%A9-%EC%9E%90%EB%8F%99%ED%99%94%EB%A5%BC-%EB%A7%8C%EB%93%A0-%EA%B3%BC%EC%A0%95-9e365c59-5905-836e-96df-bf538a101662 --- 감 매매에서 기준 기반 매매로: Claude Code와 함께 KIS API 트레이딩 자동화를 만든 과정 ### 1. 먼저 AI에게 “트레이딩 팀”을 설계하게 했습니다 처음부터 코드를 작성해달라고 요청하기보다, 제가 어떤 방식으로 투자하는 사람인지 먼저 설명했습니다. ``` 국내주식투자를 단기트레이더입장에서 하려고해. 보통 데일리, 길어야 한달이내 일정매매를 하고자해 ``` 이 요청을 바탕으로 Claude Code는 하나의 자동화 프로그램이 아니라, 역할이 나뉜 에이전트 팀을 설계해줬습니다. - **시장분석 에이전트**: 코스피·코스닥 지수와 외국인·기관 수급 확인 - **종목스크리닝 에이전트**: 조건에 맞는 종목 추리기 - **기술분석 에이전트**: 차트 패턴, RSI, MACD 등 분석 - **뉴스분석 에이전트**: 뉴스 신선도와 종목 연관성 체크 - **매매전략 에이전트**: 진입가, 손절가, 목표가 제안 - **프리마켓 에이전트**: 장 시작 전 강세 종목 추적 인상적이었던 점은, 제가 “이런 에이전트를 만들어줘”라고 하나하나 말하지 않았다는 것입니다. 투자 스타일을 설명하자 AI가 필요한 역할을 먼저 나눠줬습니다. ### 2. 매매 기준은 숫자로 구체화했습니다 자동화 시스템을 만들 때 가장 중요했던 것은 “내 기준”을 명확히 말하는 일이었습니다. 처음에는 막연하게 “좋은 종목을 찾아줘”라고 할 수도 있었지만, 그렇게 하면 결과도 막연해질 수밖에 없습니다. 그래서 제가 실제로 보는 기준을 숫자와 조건으로 구체화했습니다. ``` 당일트레이딩이 시작된 경우 시간대별 매매전략이 필요해. 하루에도 테마순환도 있을수 있어. 그리고 거래대금이 최소 1000억이상은 되어야해. 시총도 동전주는 하면 안돼. 역대최고치를 갱신하는 지도 체크해야 하고.. 뉴스가 있는 경우는 그 뉴스가 신선한지, 연관성이 있는지, 재료선반영 여부도 체크해야 해. ``` ``` 거래대금도 당일순위 10위까지하고, 프로그램매수, 외국인매수가 플러스인 종목 중심으로 선정한다. ``` ``` 뉴스의 경우 재료의 신선도가 제일중요하다. 재탕뉴스는 힘이 약하다. 처음나오는 뉴스가 임팩이 강하다. ``` 이 과정에서 배운 점은 단순했습니다. > AI에게는 “많은 종목”보다 “거래대금 1,000억 이상”이 훨씬 좋은 요청입니다. 숫자가 들어가면 AI가 코드를 만들 때 조건문으로 반영할 수 있습니다. 반대로 기준이 흐릿하면 결과물도 흐릿해졌습니다. ### 3. KIS OpenAPI 연동에서 막혔고, 공식 레포를 참고하게 했습니다 이번 자동화에서 핵심은 실시간 시세와 거래 정보를 가져오는 일이었습니다. 그래서 한국투자증권의 KIS OpenAPI를 연동하기로 했습니다. 처음에는 이렇게 물었습니다. ``` 실시간으로 종목거래상황 모니터링이 가능한가? 증권사와 연결되어 있어야 하나? ``` Claude Code가 Python 기반 연동 코드를 만들어줬고, 앱키와 시크릿 키를 설정한 뒤 실행했습니다. 그런데 실제 실행 과정에서 API 경로 오류와 시장 구분 코드 문제가 발생했습니다. 이때 직접 문서를 뒤져서 원인을 찾기보다, 공식 GitHub 레포를 Claude Code에게 전달했습니다. ``` https://github.com/koreainvestment/open-trading-api를 참조했나? 이거 한국투자증권 오픈api인거 같아 ``` 그러자 AI가 레포 구조를 참고해 다음 문제들을 찾아 수정했습니다. - API 경로 오타 - 시장 구분 코드 오류 - 토큰 발급 관련 제한 사항 - REST/WebSocket 사용 방식 차이 제가 한 일은 “공식 자료 링크를 알려준 것”이었습니다. 오류 원인을 제가 모두 이해하지 못해도, AI가 공식 자료를 기준으로 수정 방향을 찾아줬습니다. ### 4. 시간대별 자동 모니터링 구조를 만들었습니다 국내 주식은 시간대에 따라 봐야 할 데이터가 다릅니다. 장 전에는 NXT 시장이나 시간외 단일가를 보고, 9시 이후에는 정규장 데이터를 봐야 합니다. 그래서 다음과 같이 요청했습니다. ``` 8시부터 nxt시장을 모니터링하다가, 8시30분에 krx시간외단일가를 보자. 그러다가 9시부터 본장을 모니터하도록 하자 ``` 이를 바탕으로 3단계 모니터링 구조를 만들었습니다. 시간 모드 데이터 소스 08:00~08:30 NXT 시장 NXT 거래대금 순위 08:30~09:00 시간외 단일가 KRX 시간외 단일가 09:00~15:30 정규장 코스피·코스닥 실시간 이 구조 덕분에 시간에 따라 직접 화면을 바꾸지 않아도 됩니다. 정해진 시간이 되면 시스템이 자동으로 다음 단계로 넘어가고, 조건을 만족하는 종목이 나오면 알림을 줄 수 있는 구조가 되었습니다. ### 5. 실제 장 전 분석에 적용했습니다 시스템을 만든 다음 날 아침, 실제로 프리마켓 분석을 실행했습니다. ``` 지금 KST 08:00입니다. 오늘 프리마켓 분석을 시작하세요. 08:00~09:00 시간외 단일가 강세 종목을 분석하고 오늘의 매매 전략을 수립하세요. ``` 실행 흐름은 다음과 같았습니다. 1. 프리마켓 스캔 2. 시장 분석 3. 종목 스크리닝 4. 기술 분석과 뉴스 분석 병렬 실행 5. 최종 매매 전략 수립 텔레그램 뉴스 채널 10개도 함께 읽도록 구성해, 뉴스가 단순 재탕인지 새롭게 나온 재료인지 확인하는 흐름도 추가했습니다. ### 결과물 이번 작업을 통해 다음과 같은 결과물이 만들어졌습니다. - Claude Code 기반 트레이딩 자동화 하네스 - 시장분석, 종목스크리닝, 기술분석, 뉴스분석 등 6종 에이전트 - KIS OpenAPI 연동 Python 클라이언트 - 시간대별 3단계 자동 전환 모니터링 스크립트 - 텔레그램 뉴스 10개 채널 자동 수집 파이프라인 아직 실전 운용 초기라 수익률을 말하기에는 이릅니다. 하지만 가장 큰 변화는 분명했습니다. > 감으로 매매하던 흐름에서 벗어나, 기준을 세우고 그 기준을 반복적으로 확인하는 구조가 생겼습니다. ### Before / After 항목 Before After 장 전 리서치 수동으로 1~2시간 확인 명령 한 줄로 자동 실행 종목 선정 감과 경험에 의존 거래대금·수급·뉴스 기준으로 필터링 정보 확인 텔레그램, HTS, 뉴스 사이트를 따로 확인 API와 뉴스 채널을 한 흐름으로 통합 매매 원칙 머릿속에만 존재 손절, 목표가, 조건을 시스템에 반영 ### 이번 경험에서 배운 AI 활용 팁 1. 숫자로 말하면 결과가 달라집니다 ``` 거래대금이 많은 종목을 찾아줘 ``` 보다 아래 요청이 훨씬 효과적이었습니다. ``` 거래대금 1,000억 이상이고, 당일 거래대금 순위 10위 이내이며, 프로그램 매수와 외국인 매수가 플러스인 종목을 우선 선정해줘. ``` AI는 구체적인 기준이 있을수록 더 정확하게 구현합니다. 2. 공식 문서나 레포 링크를 함께 주면 좋습니다 API 연동은 자주 막히는 영역입니다. 이때 오류 메시지만 던지는 것보다 공식 문서나 GitHub 레포를 함께 주면 AI가 훨씬 잘 도와줬습니다. ``` [API 이름]을 연동했는데 오류가 발생합니다. 공식 문서/레포: [링크] 오류 메시지: [오류 내용] 이 레포를 참고해서 오류 원인을 찾고 수정해줘. ``` 이 방식은 KIS OpenAPI뿐 아니라 다른 업무용 API를 연결할 때도 그대로 사용할 수 있을 것 같습니다. 3. 코딩을 몰라도 “업무 흐름”은 설명할 수 있어야 합니다 이번 작업에서 제가 직접 복잡한 코드를 작성한 것은 아닙니다. 대신 제가 한 일은 다음에 가까웠습니다. - 어떤 정보를 보는지 설명하기 - 어떤 기준으로 판단하는지 말하기 - 실행해보고 안 되는 부분을 알려주기 - 더 필요한 조건을 추가하기 즉, 코딩 실력보다 중요한 것은 **내가 반복하는 업무를 말로 풀어내는 능력**이었습니다. ### 다른 업무에도 적용할 수 있는 부분 이번 경험은 주식 트레이딩 자동화 사례지만, 핵심은 투자에만 있지 않습니다. > 여러 곳에 흩어진 정보를 모아, 반복적으로 판단해야 하는 일은 AI 자동화의 좋은 대상입니다. 예를 들면 다음과 같은 분야에도 적용할 수 있습니다. - **부동산 투자자**: 매물 정보, 실거래가, 지역 뉴스 *동 수집 - **사업 운영자**: 경쟁사 가격, 리뷰, SNS 반응 모니터링 - **콘텐츠 크리에이터**: 트렌드 키워드, 인기 영상, 커뮤니티 반응 정리 - **마케터**: 캠페인 성과, 광고 지표, 고객 반응 요약 반복해서 확인하는 정보가 있다면, 먼저 AI에게 이렇게 물어볼 수 있습니다. ``` 내가 매일 반복해서 확인하는 정보는 다음과 같습니다. 이 작업을 자동화하려면 어떤 데이터, 도구, 워크플로우가 필요할지 설계해줘. ``` ### 앞으로의 계획 다음 단계로는 두 가지를 추가할 예정입니다. 승률 통계 자동 집계 매매 결과가 쌓이면 어떤 조건에서 성공률이 높았는지 자동으로 분석하고 싶습니다. 예를 들어 거래대금, 뉴스 신선도, 외국인 수급, 시간대별 진입 조건을 기준으로 승률을 비교할 수 있습니다. 텔레그램 봇 알림 연동 장중에 거래대금이 급증하거나 특정 조건을 만족하는 종목이 나오면, 텔레그램으로 바로 알림을 받는 구조를 만들 계획입니다. 계속 모니터를 보고 있지 않아도 중요한 신호를 놓치지 않는 것이 목표입니다. ### 프롬프트 1. 자동화 시스템 초기 설계 ``` 나는 [투자 스타일 — 예: 국내 주식 단기 트레이더]입니다. 매일 [반복하는 작업 — 예: 장 전 리서치, 종목 선별, 뉴스 확인]을 자동화하고 싶습니다. 내 기준은 [핵심 조건 — 예: 거래대금 1,000억 이상, 동전주 제외, 뉴스 신선도 체크]입니다. 이 작업을 자동화하는 에이전트 팀과 워크플로우를 설계해줘. ``` ### 프롬프트 2. API 오류 해결 ``` [API 이름]을 연동했는데 오류가 발생합니다. 공식 문서/레포: [링크] 오류 메시지: [오류 내용] 이 레포를 참고해서 오류 원인을 찾고 수정해줘. ``` ### 프롬프트 3. 내 원칙을 시스템에 반영하기 ``` 내 매매 원칙은 다음과 같습니다: - 손절: [예: -3%] - 목표가: [예: +10%] - 매매 금지 시간: [예: 오전 11:30~12:30] - 기타 규칙: [예: 오후장 돌파 금지, 물타기 최대 1회] 이 원칙들을 시스템에 반영해줘. ```