코드를 작성하지 않고 Claude Code로 일본 주식 투자 도구 2가지 만들기 전체 과정

서론

저는 규칙 기반의 주식 연구를 하는 사람입니다. 회사원 생활을 하면서 저 자신을 위해 일본 주식 투자 판단을 도와주는 도구를 만들고 있습니다.

특징은 제가 거의 코드를 직접 작성하지 않았다는 점입니다. Claude Code에게 'PM(프로젝트 매니저)' 역할을 맡기고, 이 PM이 'developer' 역할의 에이전트에게 작업을 할당하는 체제로 개발을 진행하고 있습니다.

2026년 9월 하순에 첫 번째 도구를 시작하여 약 2주 반 만에 300회 이상의 커밋(commit)을 했고, 테스트는 800건을 넘었습니다. 10월에는 두 번째 도구도 가동했습니다.

이 글에서는 다음 세 가지를 소개합니다.

• 만든 두 도구의 역할
• 'AI에게 판단을 맡기지 않는다'는 설계 사상
• 코드를 작성하지 않고 개발을 진행하는 체제

자세한 구현 내용은 다음 글에서 하나씩 작성할 예정입니다.

만든 것: 성격이 다른 두 도구

두 도구 모두 자동으로 주문을 넣지는 않습니다. 도구는 후보와 근거를 보여주는까지만 하며, 마지막 판단과 주문은 제가 증권사 화면에서 직접 합니다. 이 경계선은 사양서(仕様書)의 맨 처음에 '하지 않을 것'으로 명시되어 있습니다.

투자 가능 여부 체커: 재무로 질을 확인하다

유가증권보고서와 같은 공시 데이터에서 재무 지표를 계산하여 100점 만점의 점수를 매깁니다. 성장성, 수익성, 재무 건전성, 저평가도, 안정성의 다섯 가지에 배점을 나누어 적용합니다.

그 위에 주가 움직임(기술적 분석, テクニカル)과 시키호(四季報) 기사를 사람이 리뷰한 결과를 별개의 레이어로 판단에 사용합니다. 여기가 설계의 핵심이며, 나중에 자세히 쓰겠습니다.

급등주 체커: 테마주의 급등을 감지하다

'사이버 보안', '우주', '방위' 등 15개 테마별로 관련 종목의 움직임을 매일 살펴봅니다. 다음과 같은 징후를 정해진 규칙으로 점수화합니다.

• 미국의 관련 주식이 먼저 상승하고 있는지
• 관련된 적시 공시(TDnet)가 갑자기 늘어나지 않았는지
• 국내 관련 주식에 거래량을 동반한 급등이 확산되고 있지 않은지

테마의 종목이나 키워드는 JSON 설정 파일로 관리하기 때문에, 코드를 건드리지 않고 테마를 추가할 수 있습니다.

설계 사상: AI에게 판단을 맡기지 않는다

AI를 사용한 도구라고 하면 'AI가 매수 시점을 알려주는' 것을 상상할 수 있습니다. 제 도구는 그와 반대로, 수치 계산과 판정은 모두 정해진 규칙(코드)으로 진행하고, AI는 보조에 한정합니다.

이유가 두 가지 있습니다.

• 나중에 검증할 수 있다: 판단을 할 때마다 사용한 수치, 조건, 이유를 모두 저장합니다. 'AI가 그렇게 말했으니까'라는 이유로는, 잘 안 됐을 때 수정할 부분을 알 수 없습니다. - 데이터가 부족할 때 안전한 쪽으로 기울일 수 있다: 필요한 데이터가 빠져 있다면, 값을 추정해서 채우지 않고 강한 매수 시그널을 내보내지 않도록 합니다.

AI의 초안은 사람이 승인하기 전까지는 판단에 영향을 미치지 않습니다. 시키호 리뷰도 'AI의 안'과 '승인 후 내용'을 별도로 저장하여, AI의 안이 덮어쓰여지지 않도록 합니다.

개발 체제: 나는 코드를 작성하지 않는다

개발은 Claude Code에게 역할을 나누어 진행하고 있습니다.

| 역할 | 담당 | 할 일 | |
|---|---|---|
| 나 자신 | 인간 | 방침・투자 규칙 결정, 승인 | |
| ... | | |

이 체제를 지탱하는 것이 리포지토리 안에 둔 사양서입니다.

• docs/에 사양서를 두고, '사양서가 진실'이라고 정했습니다. 투자 가능 여부 체커의 경우 약 45개 정도 되었습니다. - 미결정 규칙은 전용 문서에 모아두고, AI가 멋대로 결정하지 못하도록 지시합니다. 결정되지 않은 것은 PM이 저에게 질문하러 옵니다. - 확정된 내용은 날짜와 함께 기록하게 하여, 다음 대화에서도 이어갈 수 있도록 합니다.

PM에게 맡기는 지침서(CLAUDE.md)에는 '저에게 물어볼 것'을 단 3가지만 적었습니다. 새로운 투자 규칙이 필요할 때, 방침을 바꿀 때, 사양서끼리 충돌할 때입니다. 그 외의 것은 PM이 사양서와 코드를 바탕으로 판단하여 진행합니다.

이 체제의 자세한 구축 과정은 다음 글에서 쓰겠습니다.

매일의 흐름 (급등주 체커 예시)

급등주 체커는 매일 아침 Mac에서 자동 실행하고 있습니다 (launchd라는 Mac의 메커니즘을 사용합니다).

• TDnet의 적시 공시를 저장합니다 (공식 웹사이트는 수 주 내에 사라지기 때문에)
• 일본 주식 및 미국 주식의 일별 데이터를 업데이트합니다
• 정부 기관 발표(RSS)와 뉴스를 수집하고, 헤드라인을 AI로 주제 분류합니다
• 정해진 규칙으로 주제별 징후를 판정합니다
• 결과를 하나의 요약 메일로 보냅니다

AI 분류에는 Claude API를 사용하며, 월 한도를 10달러로 설정했습니다. 상한을 초과할 것 같은 달은 AI 사용을 중단하고 키워드 매칭에만 전환합니다.

데이터 취급 시 주의사항

개인용 주가 데이터의 상당 부분은 이용 약관으로 공개 범위가 정해져 있습니다. 따라서 이 블로그에서는 다음 사항을 준수합니다.

• 획득한 원시 데이터(주가나 재무 수치표)는 게시하지 않습니다
• 게시하는 것은 제작 방법, 설계, 그리고 직접 조사한 기법입니다
• 특정 종목의 매매를 권장하지 않습니다

요약

• 결산을 바탕으로 판단하는 '투자 가능 여부 체커'와 급등 징후를 포착하는 '급등주 체커' 두 가지를 만들고 있습니다
• 수치 및 판정은 규칙에 따르며, AI는 초안 작성과 분류 보조에 한정합니다
• 저는 코드를 직접 작성하지 않고, 사양서와 PM 에이전트로 개발을 진행하고 있습니다.

다음 편에서는 '저는 코드를 쓰지 않습니다: PM 에이전트와 developer 에이전트의 분담'이라는 주제로 CLAUDE.md의 작성법과 작업 위임 노하우를 소개하겠습니다.

앞으로 X(@stockrules_jp)에서도 개발 진행 상황을 발신할 예정입니다.

Discussion