AI Trading Analyst — 설치 0.13초, 명령 한 줄로 종목 논거와 진입·손절·목표가를 받는 도구
키 한 장 없이 Claude Code 구독분만으로 도는 스킬 묶음입니다. 같은 종목에 같은 명령을 세 번 던져 논거가 얼마나 흔들리는지 재고, 가격 세 개를 weltiq 규칙으로 옮겨 봤습니다.
AI Trading Analyst — 설치 0.13초, 명령 한 줄로 종목 논거와 진입·손절·목표가를 받는 도구이 글의 완료 조건: 독자는 Claude Code 안에서 명령 하나로 종목 논거와 진입·손절·목표가를 받으면 성공입니다.
| 하는 일 | Claude Code 안에서 /trade thesis <티커> 를 치면 미국 주식 한 종목의 강세·약세 논거, 촉매 일정, 진입가·손절가·목표가 3단·주수가 담긴 문서 한 장이 나옵니다. 주문은 내지 않습니다 |
| 맞는 사람 | 이미 Claude Code 를 쓰고 있고, 종목 하나를 놓고 "사는 근거와 끊는 자리"를 문서로 받고 싶은 사람 |
| 안 맞는 사람 | 크립토를 보는 사람(미국 주식 전용) · 자동으로 주문까지 나가길 바라는 사람 · 실시간 시세가 필요한 사람 |
| 이 글의 결과물 | 작업 폴더에 생긴 TRADE-THESIS-NVDA.md 한 개, 그리고 그 안의 10줄짜리 실행 요약 블록 |
| 준비물·비용 | 코드 = 무료(MIT) · 모델 = Claude Code 구독분만, 별도 키 없음 · 시세 = 무료(웹 검색) · weltiq = 무료 플랜으로 붙습니다 |
| 시간·난도 | 설치 0.13초(실측) + 첫 결과 4~5분. 난도 ★☆☆☆☆ — 이 연재에서 가장 쉽습니다. 터미널에서 명령 한 줄 |
| weltiq 와의 관계 | 붙습니다 — 다만 이번엔 통합 실험입니다. 가격 세 개는 그대로 규칙이 되지만, 이 도구의 판단 기간이 몇 달짜리라 24시간 슬롯과 아귀가 안 맞습니다 |
| 검증 환경·날짜 | 2026-09-22 · macOS 15.6 · Python 3.14.7 · Claude Code 2.1.278 · 도구 커밋 c6d7252 |
| 제휴 고지 | 필자는 weltiq 로부터 이 연재의 집필 지원을 받습니다. 도구 평가는 실측만 싣고, weltiq 가 지는 칸도 그대로 씁니다 |
1. 이게 뭔가요
zubair-trabzada 가 만든 Claude Code 스킬 묶음입니다. 파이썬 패키지도 서버도 아니고, 마크다운 지시문 16장과 PDF 생성 스크립트 하나가 전부입니다. Claude Code 가 그 지시문을 읽고 웹을 검색해서 투자 분석 문서를 씁니다.
그래서 키가 하나도 없습니다. 모델은 이미 쓰고 있는 Claude Code 이고, 시세·재무·애널리스트 목표가는 전부 웹 검색으로 가져옵니다. 이 연재에서 설치가 제일 짧은 이유이자, 뒤에서 보실 가장 큰 약점이기도 합니다.
| 저장소 | github.com/zubair-trabzada/ai-trading-claude |
| 라이선스 | MIT |
| 크기 | 660KB (스킬 16 · 에이전트 5 · 파이썬 1) |
| 마지막 커밋 | 2026-04-07 |
| 시장 | 미국 주식 |
| 주문 실행 | 없음. 저장소가 첫 줄에서 "트레이딩 봇이 아니다"라고 못박습니다 |
명령은 16개인데, 실제로 가격 레벨을 내는 것은 /trade thesis 하나입니다. /trade quick 은 신호만, /trade compare 는 우열만, /trade analyze 는 아래 표에 적은 사정이 있습니다. 나머지는 읽을거리입니다.
2. 설치
한 줄입니다.
git clone https://github.com/zubair-trabzada/ai-trading-claude.git
cd ai-trading-claude && ./install.sh
원격으로 바로 받으려면 curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-trading-claude/main/install.sh | bash 입니다. 셋을 ~/.claude/ 아래에 복사할 뿐이라 0.13초에 끝납니다(실측).
Skills: 16 installed → ~/.claude/skills
Agents: 5 installed → ~/.claude/agents
Scripts: 1 installed → ~/.claude/skills/trade/scripts
설치가 끝난 화면
./install.sh 를 한 번 돌린 결과 전부입니다. 맨 아래 세 줄 — 스킬 16·에이전트 5·스크립트 1 이 각각 어디로 갔는지 — 가 보이면 설치가 끝난 것입니다. 중간의 노란 줄은 reportlab 이 없다는 경고인데, PDF 를 안 쓸 거면 무시해도 됩니다. (캡처는 실제 홈을 건드리지 않으려고 HOME 을 임시 폴더로 잡고 돌린 것이라 경로를 $HOME 으로 적었습니다.)
PDF 보고서를 쓸 계획이면 pip3 install reportlab 을 한 번 더 하십시오. 설치 스크립트는 없어도 경고만 하고 넘어갑니다. 지우려면 ./uninstall.sh 입니다.
막히는 자리
| 증상 | 왜 | 어떻게 |
|---|---|---|
/trade 를 쳐도 아무 일이 없다 |
스킬은 Claude Code 를 새로 띄울 때 읽힙니다 | Claude Code 를 종료하고 다시 여십시오. 그 뒤 /trade 가 명령 목록에 뜹니다 |
| 발동했는지 모르겠다 | 화면에 큰 배너가 뜨지 않습니다 | 세 자국 중 하나를 보십시오 — ① Launching skill: trade-thesis 한 줄 ② 웹 검색이 16회쯤 연달아 나감 ③ 작업 폴더에 TRADE-THESIS-<티커>.md 파일이 생김 |
~/.claude 를 건드리기 싫다 |
설치 스크립트가 홈 디렉터리 전역에 씁니다 | 같은 파일들을 프로젝트 폴더의 .claude/skills/·.claude/agents/ 로 복사해도 똑같이 동작합니다 |
/trade analyze 가 "5개 에이전트를 병렬로 띄웠다"고 말한다 |
그 에이전트 5개는 등록되지 않습니다(§6) | /trade thesis 를 쓰십시오. 필요한 건 다 나옵니다 |
| 말로 부탁했는데 이 도구가 안 붙는다 | 말투에 따라 다른 스킬이 붙거나 아무것도 안 붙습니다(§4) | 슬래시 명령을 직접 치십시오 — /trade thesis NVDA |
3. 첫 결과
/trade thesis NVDA
4~5분 뒤 TRADE-THESIS-NVDA.md 가 생깁니다. 10개 절짜리 문서인데, 마지막 절 하나만 보면 됩니다.
TICKER: NVDA
DIRECTION: LONG
ENTRY: $222.60 (limit order)
STOP LOSS: $211.00 (-5.2%)
TARGET 1: $235.75 (+5.9%) — sell 33%
TARGET 2: $280.00 (+25.8%) — sell 33%
TARGET 3: $315.00 (+41.5%) — sell remaining
RISK/REWARD: 1.1:1 to T1; 4.7:1 blended across T1/T2/T3
POSITION SIZE: 22 shares ($4,897.20) for $50K account — the 10% portfolio cap
is the binding limit, not the 2% risk rule
TIMEFRAME: 3-6 months
NEXT CATALYST: Q3 FY2027 earnings on 2026-11-17
/trade thesis NVDA 가 내놓은 열 줄
이 도구가 일하는 화면입니다. 위 두 줄이 문서가 잡은 기준시각과 기준가(2026-09-21 종가 $227.38)이고, 초록색 블록이 마지막 절입니다. 진입 $222.60 이 기준가보다 아래라는 것 — 지금 사라가 아니라 내려오면 사라는 말이라는 것 — 을 보십시오. 5절에서 이 한 줄이 문제가 됩니다.
이게 나오면 성공입니다. 방향·진입·손절·목표가 세 개·주수·기간·다음 촉매가 한 블록에 있습니다. 위쪽 아홉 절은 이 열 줄이 왜 그렇게 정해졌는지에 대한 설명입니다.
대시보드는 없습니다. 웹 UI 도 TUI 도 없고, Claude Code 터미널 출력과 작업 폴더에 떨어지는 마크다운 파일이 전부입니다. 띄울 주소를 찾지 마십시오. 그림으로 보고 싶다면 /trade report-pdf 가 PDF 를 만들어 주는데, 그게 6절에서 걸리는 자리입니다.
그리고 이 도구가 스스로 깎은 칸도 같이 옵니다. 위 실행은 확신도를 Medium, 비대칭성을 6/10 으로 적었고, 진입 조건이 지금은 맞지 않는다고 본문에 썼습니다 — 진입가 222.60 이 당시 종가보다 아래라 "눌림을 기다리라"는 주문이었습니다.
4. 제일 잘 쓰는 법 — 같은 질문을 세 번 던져 보십시오
이 도구의 출력은 매끈합니다. 매끈한 출력은 근거가 얼마나 흔들리는지를 감춥니다. 그래서 같은 명령을 서로 다른 세션에서 세 번 던져 봤습니다.
| 방향 | 진입 | 손절 | 목표1 | 주수 | 기간 | 확신도 | |
|---|---|---|---|---|---|---|---|
| 1회 | LONG | 222.60 | 211.00 | 235.75 | 22주 | 3–6개월 | Medium |
| 2회 | LONG | 217.65 | 204.40 | 233.00 | 22주 | 3–6개월 | Medium |
| 3회 | LONG | 217.65 | 208.00 | 233.00 | 22주 | 2–4개월 | Medium |
방향은 3/3 일치하고, 목표가와 주수도 거의 같습니다. 주수 22는 세 번 모두 "2% 위험 규칙이 아니라 10% 집중도 상한이 먼저 걸린다"는 같은 계산을 따로 해서 나온 값입니다.
흔들리는 칸은 손절입니다. 204.40 / 208.00 / 211.00 — 최대 3.2% 벌어집니다. 손절가는 위험의 크기를 정하는 숫자이므로, 세 번 중 어느 것을 쓰느냐로 같은 판단의 위험이 달라집니다. 한 번만 돌리고 그 숫자를 그대로 쓰면 이 폭이 안 보입니다.
왜 흔들리는지도 문서가 말해 줍니다. 이 도구는 시세 API가 없고 웹 검색이 자료원입니다. 같은 날 같은 종목에서 이렇게 갈렸습니다.
| 검색이 돌려준 값 | |
|---|---|
| 현재가 | $227.38 / $222.27 / (다른 출처) $270.34 |
| RSI(14) | 60.4 / 54.54 / 49.94 / 80.31 |
| 선행 PER | 20.2 / 18.20 / 24.50 / 37.2 / 46 |
| 다음 실적일 | 2026-11-17 / 2026-11-25 |
정직한 점은, 세 번 모두 충돌을 숨기지 않았다는 것입니다. 2회차 문서는 맨 위에 "다른 가격 집합이 맞다면 이 문서의 모든 레벨이 무효"라고 적었고, 3회차는 "한 출처가 골든크로스라고 썼는데 그 출처 자신의 50일 이평(217.65)이 200일(220.21) 아래다. 라벨이 아니라 숫자를 썼다"고 적었습니다. 지시문이 "숫자를 지어내지 말라"고 시켰고, 실제로 지켜집니다.
그래서 이렇게 쓰시는 게 낫습니다: 세 번 돌려 방향이 갈리면 그날은 넘기고, 방향이 같으면 손절은 셋 중 가장 보수적인 것(진입에서 가장 먼 것)을 쓰십시오. 그리고 현재가는 문서를 믿지 말고 본인 증권사 화면에서 한 번 확인하십시오. 위 세 실행 중 둘이 쓴 $222.27 은 실제 종가보다 5달러 낮았습니다.
그리고: 말로 부탁하지 마십시오
스킬은 말투를 보고 붙습니다. 그래서 같은 요청을 세 가지 방식으로 세 번씩 던져 봤습니다.
| 어떻게 말했나 | 붙은 것 |
|---|---|
| "NVDA 를 거래해서 수익을 내 줘. 왜 그렇게 했는지도 설명해 줘" | 0/3 — 아무것도 안 붙습니다. 세 번 모두 "주문을 낼 수 없다"며 거절하고 대안을 제시합니다 |
| "NVDA 투자 논거를 진입가·손절가·목표가와 함께 만들어 줘" | 3/3 — 다른 금융 스킬이 붙었습니다. 이 기계에는 다른 투자 분석 스킬이 깔려 있었고, 세 번 모두 그쪽이 이겼습니다 |
| 같은 문장, 이 도구만 깔린 폴더에서 | 3/3 이 도구가 붙습니다 |
/trade thesis NVDA |
1/1 즉시 고정. 되묻지 않고 바로 시작합니다 |
읽을 점 둘입니다. 하나, "거래해 줘"는 이 도구를 부르지 못합니다 — 주문 요청으로 읽혀 거절로 갑니다. 둘, 금융 관련 스킬을 여러 개 깔아 두면 어느 것이 붙었는지 모른 채 결과를 받습니다. 둘 다 답은 같습니다 — 슬래시 명령을 직접 치십시오.
곁들여: 종목을 고르고 싶을 때
/trade compare NVDA AMD INTC 를 실제로 돌려 봤습니다. 세 번째 티커는 버립니다 — 지시문이 "앞의 둘만 쓰고 나머지는 무시한다"고 적어 뒀고, INTC 는 검색조차 되지 않았습니다. 승자는 나오지만(NVDA 8.7 vs AMD 6.3) 가격 레벨은 한 개도 나오지 않습니다.
셋 중에 고르려면 쌍대 비교를 세 번 돌려 토너먼트를 짜고, 이긴 종목에 다시 /trade thesis 를 걸어야 진입·손절이 나옵니다.
5. weltiq 로 옮기기 — 통합 실험
weltiq 는 전략을 24시간 무인으로 돌려 주는 실행 인프라입니다. 이 도구가 가격 세 개를 내놓으니, 그 세 개를 규칙으로 옮겨 슬롯 하나에 태워 봤습니다.
weltiq 준비 (여기까지는 어느 편이나 같습니다)
가입({{CTA_URL}}) → 마이 → 연결 관리에서 키 발급 → claude mcp add weltiq ...
옮긴 순서 — 세 단계
① 규칙으로 쓴다 진입 close ≤ 222.60 → 롱 / 손절 211.00 / 목표 235.75
② 근거를 내 말로 쓴다 "왜 수익이 나는가 / 언제 논리가 깨지는가 / 무효 조건은 숫자로"
③ 테두리를 치고 띄운다 자본 1만 달러, 누적 손실 300달러에서 중지, 시간이 지나면 자동 종료
②는 건너뛸 수 없습니다. 근거 없이 던지면 weltiq 가 세 질문을 돌려주며 거절합니다. 그런데 이 도구는 그 세 칸을 이미 갖고 있습니다.
| weltiq 가 묻는 것 | 이 도구가 이미 쓰는 칸 |
|---|---|
| 이 전략이 수익을 내는 이유를 한 문장으로 | Executive Summary — 논거 2~3문장 |
| 어떤 조건에서 논리가 깨집니까 | Entry Invalidation — "212.00 아래로 평균 이상 거래량을 동반해 닫히면 이 문서의 모든 가격이 무효" |
| 무효 조건을 숫자로 | 같은 칸이 가격으로 적혀 있습니다 |
옮기는 데 든 것은 연산 여섯 개입니다. 09편의 InvestSkill 과 같은 크기이고, 이유도 같습니다 — 출력이 "가격 세 개와 그게 틀렸다고 볼 조건" 이라서입니다.
옮겨지지 않은 것
- 목표가 2·3 (280 / 315)과 33/33/34% 분할 매도. weltiq 의 가격 조건 청산은 손절·목표 두 칸뿐입니다. 3단 익절을 담을 칸이 없습니다
- 22주. 이 계정으로 올린 문서가 그때는 한 번에 1주까지만 주문할 수 있어 1주로 줄였습니다. 크기는 weltiq 쪽 제약이지 도구의 판단이 아니었습니다. 이 제약은 2026-09-23 에 없어졌습니다 — 지금은 규칙 문서의
sizing.qty가 곧 주문 상한이라 22주가 그대로 들어갑니다. 아래 실측은 1주로 줄인 그날의 기록입니다 - 3~6개월이라는 기간. 여기가 이 조합의 진짜 벽입니다
결과 — 체결은 확인하지 못했습니다. 슬롯은 떴고 진입 조건·손절·목표가가 요약줄에 그대로 실렸습니다. 그러나 체결은 0건이었고, 이유가 둘입니다. 하나는 실측 시각이 미국장 마감 뒤였다는 것. 다른 하나가 더 중요합니다 — 이 도구가 낸 진입가 222.60 은 마지막 종가 227.30 보다 아래입니다. 장이 열려 있었어도 눌림이 오기 전에는 사지 않습니다. 세 번의 실행이 전부 그랬습니다.
그래서 이 조합의 정직한 결론은 이렇습니다. 이 도구는 "지금 사라"를 말하지 않습니다. 몇 달을 두고 특정 가격까지 내려오면 사라고 말합니다. 그 판단을 24시간짜리 무인 슬롯에 태우면, 대부분의 날은 아무 일도 일어나지 않는 것이 정상입니다. 붙이려면 둘 중 하나를 골라야 합니다 — 명령에 "오늘 안에 체결될 자리로"를 덧붙여 기간을 좁히거나, 슬롯을 주 단위로 길게 두고 눌림을 기다리거나.
지금 이 글은 후자를 확인하지 못했습니다. 장이 닫혀 있었고, 슬롯은 만든 뒤 바로 정지·삭제했습니다. 통합 실험이라고 부르는 이유입니다.
6. 써 보니
좋은 점
- 설치 0.13초, 키 0개. Claude Code 만 있으면 끝입니다. 이 연재에서 가장 낮은 진입 장벽입니다
- 출력이 주문 언어로 되어 있습니다. 방향·진입·손절·목표·주수·기간이 고정 서식 한 블록에 있어서 어디로든 옮기기 쉽습니다
- 무효 조건을 숫자로 적습니다. "언제 내가 틀린 것인가"를 가격으로 적게 시키는 도구는 많지 않습니다
- 모르는 것을 모른다고 씁니다. 세 실행 전부 "Data unavailable" 목록과 출처 충돌을 문서 안에 남겼습니다. 숫자를 지어내지 않았습니다
나쁜 점
- "5개 에이전트 병렬"은 사실이 아닙니다.
/trade analyze가 부른다는 에이전트 5개는 파일에 필수 머리말이 없어 등록되지 않습니다. 실제로는 같은 대화 안에서 스킬 다섯 개를 연달아 부르고, 그러고는 "지금 백그라운드에서 돌고 있다"고 잘못 말합니다. 설치되는 에이전트 파일 5개는 죽은 파일입니다 /trade report-pdf는 문서대로 하면 틀린 보고서를 냅니다. 지시문이 만들라는 JSON 과 파이썬 스크립트가 읽는 JSON 의 키 이름이 서로 다릅니다. 지시문대로 만들어 넣으면 스크립트가 못 찾은 값을 기본값으로 채워서, NVDA 매수 분석이 AAPL · 0점 · F · AVOID 로 나옵니다
지시문대로 만든 페이로드로 뽑은 PDF 1쪽
NVDA 분석을 넣었는데 표지가 AAPL 이고 점수가 0점, 신호가 AVOID 입니다. 넣은 값이 하나도 읽히지 않았다는 뜻입니다.
같은 PDF 2쪽 — 점수 대시보드
막대 다섯 개(72·68·61·55·65)는 제가 넣은 숫자가 아니라 스크립트에 박혀 있는 예시값입니다. 합계만 0점으로 찍혀 서로 모순됩니다.
스크립트가 실제로 읽는 키(ticker / overall_score / categories / technical / fundamental / thesis / risk)로 다시 만들면 제대로 나옵니다.
실제 스키마로 다시 만든 PDF 1쪽
같은 스크립트, 같은 분석. 키 이름만 스크립트가 읽는 쪽으로 맞춘 결과입니다.
- 시세가 웹 검색입니다. 현재가가 같은 날 $222.27 과 $270.34 로 갈리는 자료 위에서 진입가와 손절가가 계산됩니다. 장중 판단에는 쓸 수 없습니다
- 마지막 커밋이 2026-04-07 입니다. 다섯 달 반 동안 손대지 않았습니다. 위 두 결함이 그동안 안 고쳐진 이유로 보입니다
비용
| 항목 | 금액 |
|---|---|
| 설치·코드 | $0 (MIT) |
| 금융 데이터 구독 | $0 — 없음 |
| 모델 | Claude Code 구독분. 한 번 실행에 웹 검색 16~17회, 4~5분 |
| weltiq | 무료 플랜으로 붙습니다 |
7. 다음 행동
먼저 /trade thesis 를 한 종목에 세 번 돌려 보십시오. 방향이 3/3 같고 손절 폭이 1% 안에 모이면 그 판단은 꽤 단단한 것이고, 손절이 3% 넘게 벌어지면 그날 웹이 흔들린 것입니다. 이 도구는 그 차이를 스스로 말해 주지 않으니 세 번 던져서 보는 수밖에 없습니다.
그 다음이 이 글이 못 닫은 자리입니다. 이 도구의 판단은 몇 달짜리인데 무인 실행은 하루나 일주일 단위로 겁니다. 다음 편의 trading-bot-agent 는 반대로 장중에 돌 것을 전제로 만들어진 도구라, 같은 질문에 어느 쪽 대답이 무인 실행에 더 잘 앉는지를 나란히 놓고 볼 수 있습니다.
weltiq 로 이어서 해 보기
이 도구가 낸 진입가·손절가·목표가를 실제 가격과 실제 수수료 위에서 24시간 돌려 보고 싶다면 —
- 가입 → {{CTA_URL}}
- 마이 → 연결 관리에서 키를 발급
claude mcp add weltiq ...로 Claude Code 에 연결무료 플랜으로 슬롯 하나를 띄울 수 있습니다. 모의 실행이고 실주문은 나가지 않습니다.
이 글의 모든 숫자는 2026-09-22 실측입니다. 원문 로그·JSON·실패한 시도까지 전부 검증 기록에 있습니다. 매매 의견이 아닙니다.