// KIS 환경을 진단하거나 설치할 때 반드시 사용. '환경 확인', '설치해줘', 'setup', 'kis-setup'이라고 할 때 자동 실행된다.
KIS 인증이 필요할 때 반드시 사용. '인증해줘', '모의투자 인증', '실전 인증', '토큰 갱신', 'auth vps', 'auth prod', 'auth switch'라고 할 때 자동 실행된다.
KIS 플러그인 사용법을 안내할 때 사용. '사용법', '도움말', '커맨드 목록', '오류코드', 'kis-help'라고 할 때 자동 실행된다.
KIS 계좌 상태를 조회할 때 반드시 사용. '잔고 확인', '보유종목', '내 계좌', '지수 확인', 'my-status'라고 할 때 자동 실행된다.
KIS 전략을 과거 데이터로 검증하거나 성과를 확인할 때 반드시 사용. '백테스팅', '백테스트 해줘', '전략 검증', '성과 분석', '파라미터 최적화', '수익률 확인', '과거 검증', '샤프 확인', '최대낙폭 보고 싶어', '이 전략 수익률이 어떻게 돼?'라고 할 때 자동 실행된다. backtester MCP 서버를 통해 10개 프리셋(sma_crossover, momentum 등) 또는 .kis.yaml 전략 실행, BacktestResult(총수익률·CAGR·최대낙폭·샤프) 해석, Grid/Random 파라미터 최적화, 배치 전략 비교, 포트폴리오 분석, HTML 리포트 생성을 수행한다.
Handle KIS customer-service style support. Use when users are confused, report errors, ask unsupported/illegal requests, request direct stock picks, or need policy-safe alternatives.
KIS 전략의 실시간 신호를 확인하거나 주문을 실행할 때 반드시 사용. '전략 실행해줘', '신호 확인', '종목 돌려봐줘', '매수 신호 있어?', '매도 타이밍', '실시간 매매', '자동매매', '삼성전자 지금 들어가도 돼?', '이 전략으로 주문 넣어줘'라고 할 때 자동 실행된다. 종목 코드를 먼저 선택한 뒤 전략을 실행해 BUY·SELL·HOLD 신호와 강도(0~1)를 확인하고, 신호 강도에 따라 모의(vps)/실전(prod) 주문을 실행한다. 실전투자 주문 전 반드시 사용자 확인을 받는다.
| name | kis-setup |
| description | KIS 환경을 진단하거나 설치할 때 반드시 사용. '환경 확인', '설치해줘', 'setup', 'kis-setup'이라고 할 때 자동 실행된다. |
uv run <프로젝트루트>/.codex/scripts/setup_check.py <프로젝트루트>| 입력 | 동작 |
|---|---|
| (인자 없음) | 전체 진단 + 실패 항목 순서대로 수정 |
check, status, 상태 | 진단만 수행, 수정 없음 |
p1 | P1만 설치 (uv sync + pnpm install) |
p2 | P2만 설치 (uv sync + pnpm install + lean) |
lean | Lean 환경만 설정 |
mcp | MCP 서버 시작만 |
setup_check.py <프로젝트루트> 실행 후 상태 표로 출력.
all_ok가 true면 "모든 설정이 완료되었습니다!"라고 안내 후 종료.
| 항목 | 안내 |
|---|---|
| Python | brew install python@3.11 또는 공식 사이트 |
| uv | curl -LsSf https://astral.sh/uv/install.sh | sh |
| Node.js | brew install node 또는 nvm |
| Docker 미설치 | docker.com/products/docker-desktop |
| Docker 미실행 | "Docker Desktop을 시작해주세요" 안내 후 대기 |
~/KIS/config/kis_devlp.yaml 없으면 아래 템플릿 안내:
my_app: "실전투자 앱키"
my_sec: "실전투자 앱시크릿"
paper_app: "모의투자 앱키"
paper_sec: "모의투자 앱시크릿"
my_htsid: "HTS ID"
my_acct_stock: "증권계좌 8자리"
my_paper_stock: "모의투자 증권계좌 8자리"
my_prod: "01"
절대로 config 파일을 직접 읽거나 쓰지 않는다.
cd strategy_builder && uv sync + cd frontend && pnpm install + .env.local 없으면 생성:
cp strategy_builder/frontend/.env.example strategy_builder/frontend/.env.local
⚠️ 호가창 WebSocket(실시간 호가)을 사용하려면
.env.local의NEXT_PUBLIC_API_URL=http://localhost:8000설정이 필수입니다.
cd backtester && uv sync + cd frontend && pnpm installbash backtester/scripts/setup_lean_data.shbash backtester/scripts/start_mcp.sh 백그라운드 실행 후 http://127.0.0.1:3846/health 확인.
"모의투자로 시작하려면 '인증해줘 vps'를 입력하세요."
kis_devlp.yaml을 직접 읽거나 쓰지 않는다.