💬

바이브코딩 (Vibe Coding) — 사용자 가이드

상태: Beta

iQ 스튜디오 안에서 자연어로 퀀트 전략 코드를 만들고 다듬는 AI 도우미입니다.
"말하면 전략이 됩니다" — 필터 조건 추가, 손절 로직 도입, API 사용법 질문까지 대화로 해결하세요.

1. 시작하기

바이브코딩은 스튜디오 편집기 영역 안에 내장된 채팅형 도우미입니다. 별도 설치나 진입 없이 전략을 열기만 하면 바로 사용할 수 있습니다.

스튜디오에서 전략을 엽니다. 편집기 영역 상단에 [전략코드 편집기] / [바이브코딩] 두 개의 탭이 나타납니다.

[바이브코딩] 탭을 선택합니다. 채팅창 형태의 대화 인터페이스가 열립니다. 바이브코딩은 [전략코드 편집기] 탭에 보이는 코드를 항상 "현재 전략"의 기준으로 인식합니다.

탭 오른쪽의 배열 아이콘(좌우/상하)을 누르면 화면을 분할해, 전략코드 편집기와 바이브코딩을 나란히 볼 수 있습니다. 코드를 직접 보면서 대화하고 싶을 때 유용하며, 같은 아이콘을 다시 누르면 원래의 탭 전환 모드로 돌아갑니다.

탭 오른쪽의 톱니바퀴 아이콘을 누르면 바이브코딩 설정(테마·글자 크기·자동 코드반영 등)이 바로 열립니다. (7장 참고)

하단 입력창에 원하는 것을 자연어로 입력하고 Enter로 전송합니다. 문장으로 편하게 적으면 됩니다. 예: "PER 10 이하 종목만 남기고 싶어."

방향키(↑/↓)로 이전 질문을 다시 불러올 수 있습니다. 같은 전략 안에서 이전에 보냈던 질문들이 순서대로 저장되어 있어, 비슷한 질문을 다시 하거나 수정해서 보낼 때 유용합니다. (전략별로 별도 저장되므로 다른 전략을 열면 그 전략의 히스토리가 나타납니다.)

입력창에 /를 입력하면 슬래시 커맨드 목록이 뜹니다. 3장에서 설명하는 모든 길잡이 기능(맞춤 전략 생성, 전략 건강검진, 보스전 등)을 마우스로 메뉴를 찾아다닐 필요 없이 입력창에서 바로 실행할 수 있습니다.

 블록(Blockly) 방식으로 만든 전략은 바이브코딩을 지원하지 않습니다. 블록 전략을 열면 [바이브코딩] 탭 자체가 표시되지 않습니다. 바이브코딩을 사용하려면 스크립트(코드) 전략이어야 합니다.

 처음 사용하신다면 3장의 [처음이라면 따라하기] 코스로 시작하시는 것을 권장합니다.

2. 두 가지 응답 방식

바이브코딩은 사용자의 요청 의도를 자동으로 판단해서, 요청이 "코드를 바꿔달라"는 것인지 "설명해달라"는 것인지에 따라 다르게 응답합니다. 별도로 모드를 선택할 필요가 없습니다.

(A) 코드 생성·수정 요청

예: "PER 10 이하 필터 추가해줘", "약세장에 손절 강화 도입해줘"

•

AI가 변경 제안을 diff(비교) 형태로 실시간 스트리밍하며 보여줍니다. 추가되는 줄은 +, 삭제되는 줄은 로 표시되고, 바뀌지 않는 부분은 그대로 유지되어 보입니다.

•

응답 하단에는 무엇이 왜 바뀌었는지 요약과 함께, 이어서 물어볼 만한 후속 질문 5개가 제시됩니다. 후속 질문을 클릭하면 바로 그 질문이 전송됩니다.

•

diff는 검토용 제안일 뿐이며, 이 시점에는 편집기의 실제 전략 코드가 바뀌지 않습니다.

•

검토 후 [코드반영] 버튼을 눌러야 편집기의 전략 코드에 실제로 적용됩니다.

•

설정 > 자동 코드반영을 켜두면, 코드 응답이 끝날 때 버튼을 누르지 않아도 자동으로 전략 코드에 적용됩니다. (단, [코드병합] 결과로 처리되는 응답은 자동반영 대상에서 제외됩니다. 기본값은 꺼짐입니다.)

•

응답이 완전히 끝나면 입력창 위에 짧게 "응답 완료" 표시가 나타나 다음 요청을 이어서 입력할 수 있는 시점을 알려줍니다.

(B) 일반 질문

예: "getRank 사용법 알려줘", "이 전략이 왜 손실이 나?"

•

AI가 코드를 바꾸지 않고 설명 형태로 답합니다.

•

답변 중 예시 코드가 포함된 경우, [코드병합] 버튼으로 현재 전략에 통합할 수 있습니다. (직접 복사해서 붙여넣기보다 이 버튼을 사용하는 것을 권장합니다 — 8장 참고)

 두 방식 모두 편집기 코드는 사용자가 명시적으로 반영(또는 자동반영 설정)하기 전까지 바뀌지 않습니다. 이는 바이브코딩의 핵심 안전 원칙입니다(5장 참고).

3. AI 길잡이 메뉴

바이브코딩 패널 우측 상단의 길잡이 아이콘(또는 입력창에서 / 슬래시 커맨드)을 통해 아래 기능들을 바로 실행할 수 있습니다. 크게 "전략 만들기", "전략 점검하기", "배우기", "기타"로 구분됩니다.

전략 만들기

기능	설명
맞춤형 전략 만들기	몇 가지 질문(투자 성향 진단)에 답하면, 그 답변을 바탕으로 나에게 맞는 전략을 처음부터 생성해줍니다. 투자 경험이 적거나 어떤 조건부터 시작할지 막막할 때 추천합니다.
전략 조립하기	종목 선정 기준, 리밸런싱 주기 등 구체적인 조건을 하나씩 선택하면서 전략을 단계적으로 조립합니다. 원하는 조건이 명확할 때 유용합니다.
관심 종목 담기	세부 조건 대신 원하는 종목의 "느낌"(테마·스타일)만 골라 담으면, 그에 맞는 종목군을 구성해줍니다.
투자 대상 정하기	거래할 시장(국내/해외), 업종, 종목 선정 우선순위 등 투자 대상의 범위를 먼저 설정하고 싶을 때 사용합니다.

전략 점검하기

기능	설명
내 전략 한눈에	현재 전략을 이해하기 쉬운 카드 형태로 요약해서 보여줍니다. 코드를 직접 읽지 않아도 전략의 핵심 로직을 파악할 수 있습니다.
전략 건강검진	실행 전 코드에 잠재된 위험 요소를 자동으로 점검해 [위험]·[주의]·[양호] 세 단계로 표시합니다. 지적된 항목만 골라서 AI에게 수정을 요청할 수 있어, 문제 되는 부분만 효율적으로 고칠 수 있습니다.
하락장 멘탈 리허설	이 전략이 과거의 최악 하락 구간에서 어떻게 움직였을지 미리 체험해볼 수 있습니다. 실제로 그 상황이 왔을 때 심리적으로 버틸 수 있는 전략인지 사전에 점검하는 데 도움이 됩니다.
역사적 위기 보스전	금융위기, 코로나 등 실제 역사 속 위기 구간에 내 전략을 백테스트해 등급을 매기는 도전 모드입니다. (4장에서 상세히 설명)

배우기

기능	설명
처음이라면 따라하기	전략 생성부터 건강검진까지 이어지는 6단계 온보딩 코스입니다. 바이브코딩이 처음이라면 이 순서대로 따라 해보세요.
내 전략 만들기 따라하기	조립하기부터 결과 확인까지 이어지는 4단계 코스로, 이미 만들고 싶은 전략의 방향이 있는 분께 적합합니다.
바이브코딩 사용법	바이브코딩 화면 안에서 각 기능의 사용법을 바로 확인할 수 있는 인앱 도움말입니다. 이 문서(서비스 가이드)와는 별개로, 스튜디오 화면을 벗어나지 않고 빠르게 참고할 때 유용합니다.

기타

기능	설명
설정	글자 크기, 테마(라이트/다크/시스템 설정), 편집기 자동 줄 바꿈, 자동 코드반영, 내 포인트로 AI 사용 여부를 관리합니다. (7장 참고)

4. 역사적 위기 보스전

실제 역사 속 위기 구간(카드 사태, 글로벌 금융위기, 유럽 재정위기, 차이나 쇼크, 코로나19, 금리 인상기 등)을 "보스"로 설정하고, 내 전략이 그 구간을 얼마나 잘 버텨내는지 도전하는 게임화된 검증 모드입니다.

진행 방법

보스 캐릭터 카드 중 도전할 위기 구간을 고르고 [도전]을 누릅니다.

해당 위기 기간을 대상으로 백테스트가 자동 실행되고, 완료되면 결과가 자동으로 판정됩니다.

결과 카드에서 [방어 보강 요청]을 누르면 AI가 개선 코드를 제안합니다. [코드반영] 후 [재도전]을 눌러 다시 도전할 수 있습니다.

판정 기준 (4축)

축	의미
참여	위기 구간에 실제로 투자에 참여했는가 (미달 시 곧바로 회피 판정 F)
생존	최대 낙폭(MDD)이 해당 보스별로 정해진 한도 이내인가
선방	수익률이 시장(벤치마크) 대비 우위에 있는가
회복	저점 이후 반등에 올라탔는가 (반등폭, 플러스 마감, 시장 복귀 중 하나 이상 충족하면 인정)

등급 체계

•

A: 4축 모두 통과

•

B: 1개 실패

•

C: 2개 실패

•

D: 3개 이상 실패

•

F(회피): 참여 기준 미달

•

S: A 조건을 충족하면서, 초과수익·낙폭 여유 등 상위 조건까지 달성한 최상위 정복 등급

기록 관리

•

보스별 최고 기록(등급·도전 차수)이 캐릭터 카드의 배지에 표시됩니다. 배지에 마우스를 올리면 그 기록을 달성한 전략의 제목을 확인할 수 있습니다.

•

재도전 결과가 이전보다 나빠지면, 결과 카드에 역대 최고 기록이 함께 표시되고 [복원]을 눌러 그때의 코드와 결과로 되돌릴 수 있습니다.

•

지난 도전과 코드가 동일하면 재도전이 차단됩니다. (같은 코드로는 결과가 달라질 수 없기 때문입니다.) 방어 보강 요청으로 받은 코드를 반영한 뒤 다시 도전하세요.

5. 코드 안전장치

바이브코딩은 AI가 생성한 코드를 사용자 확인 없이 실행하지 않는다는 원칙 위에서 설계되었습니다. 아래는 이를 뒷받침하는 세부 장치들입니다.

5.1 잘못된 API 자동 감지·수정

•

존재하지 않는 함수, 속성을 함수처럼 잘못 호출한 경우 등은 가능한 한 별도 표시 없이 즉시 교정되어 diff에 자연스럽게 반영됩니다.

•

자동 교정을 위해 별도 판단이 더 필요한 경우에만 "잘못된 API 감지" 배너로 알리고 수정을 시도합니다. 수정이 불가능하면 "미해결"로 안내됩니다.

5.2 모의 실행 검증

•

생성된 코드를 실제 백테스트 실행 전에 내부적으로 한 번 모의 실행해봄으로써, 런타임 에러를 사전에 잡아내고 자동으로 수정합니다.

5.3 에러수정 (백테스트 결과 기반)

•

백테스트 실행 후 로그 탭에 빨간 에러 메시지가 있으면, 마지막 에러 줄 바로 아래 [에러수정] 버튼이 나타납니다.

•

필터 조건이 과도해 선정된 종목이 하나도 없어 잔고보유내역이 비는 경우에도, 안내 메시지와 함께 [에러수정] 버튼이 제공됩니다.

5.4 코드 히스토리·복원

•

[코드반영] 또는 편집기에서 직접 저장한 시점의 코드가 히스토리로 계속 쌓입니다.

•

히스토리에 남은 어떤 시점으로도 자유롭게 복원할 수 있습니다.

•

[전략코드 저장]으로 편집기에서 직접 고친 코드도 "직접 수정본"이라는 이름으로 히스토리에 함께 기록되어, AI 반영본과 구분해서 관리할 수 있습니다.

참고: 바이브코딩의 핵심 안전 원칙

사용자가 승인하기 전까지 편집기 코드는 바뀌지 않습니다.

어떤 변경도 항상 되돌릴 수 있습니다.

AI가 확신할 수 없는 판단은 "미판정"으로 표시하며, 근거 없이 단정하지 않습니다.

존재하지 않는 API는 실행 전에 걸러집니다.

AI가 생성한 결과는 완성본이 아니라 검토를 거쳐야 하는 시작점입니다.

생성한 전략은 계정별로 비공개 저장됩니다.

6. 대화·사용량

•

전략별 대화 저장: 대화 내용은 전략 단위로 저장되어, 탭을 이동하거나 새로고침해도 유지됩니다.

•

자동 요약: 대화가 길어지면 오래된 내용이 자동으로 요약(압축)됩니다. 맥락은 유지되면서 토큰 사용은 절약됩니다.

•

하단 상태바에서 아래 두 가지를 항상 확인할 수 있습니다.

◦

대화 내용 n%: 현재 대화가 차지하는 맥락(context) 크기 비율

◦

일일 사용량 n%: 오늘 사용한 토큰 비율 (원형 게이지, 색상 단계  여유 →  주의 →  임박, 매일 초기화)

•

삭제: 버튼을 눌러 현재 전략의 대화 내용을 비울 수 있습니다.

멤버십별 사용량 안내

등급	일일 사용량	초과 시
BASIC	체험 수준의 한도	한도 초과 시 이용 불가 (포인트로 추가 이용 불가)
PRO	표준 한도	포인트로 추가 이용 가능
PREMIUM	표준의 5배 한도	포인트로 추가 이용 가능

•

일일 무료 한도를 넘긴 뒤 포인트로 사용하는 경우, 각 응답이 끝날 때마다 실제 토큰 사용량이 즉시 포인트로 차감됩니다. 포인트 사용 첫 요청 전에 하루 1회 확인 팝업이 표시됩니다.

•

내 포인트로 AI 사용 설정에서 언제든 켜고 끌 수 있습니다.

7. 설정

탭 오른쪽의 톱니바퀴 아이콘을 누르면 설정 패널이 열리며, 아래 항목을 관리할 수 있습니다.

항목	옵션	설명
글자 크기	- / + (기본 16px)	바이브코딩 탭 전체(내용·버튼·카드 등)에 적용됩니다.
테마	라이트 / 다크 / 시스템 설정	기본값은 시스템 설정으로, OS의 라이트·다크 모드를 그대로 따릅니다.
편집기 자동 줄 바꿈	끄기 / 켜기	전략코드 편집기에서 긴 줄을 가로 스크롤 없이 다음 줄로 넘겨 표시합니다.
자동 코드반영	끄기 / 켜기	생성된 코드를 자동으로 전략코드에 반영합니다. [코드병합] 결과는 자동반영 대상에서 제외됩니다.
내 포인트로 AI 사용	끄기 / 켜기	일일 토큰 사용량을 모두 소진한 후에도 내 포인트로 계속 사용합니다.

 위 설정들은 모두 계정 단위로 저장되어, PC와 모바일 등 다른 기기에서 접속해도 동일하게 적용됩니다.

8. 잘 쓰는 팁

•

명확하게 요청하세요. 무엇을, 어떤 조건으로 바꾸고 싶은지 구체적으로 적을수록 원하는 결과에 가까운 코드가 나옵니다.

•

이어서 수정할 땐 먼저 코드반영을 하세요. 반영을 해야 다음 질문에 대한 답변이 최신 코드를 기준으로 만들어집니다. 반영하지 않은 채 계속 질문하면 AI가 옛 코드를 기준으로 답할 수 있습니다.

•

추천 질문을 적극 활용하세요. 답변 하단에 뜨는 "추가 질문"을 클릭하면 그 자체로 다음 요청이 전송됩니다.

•

예시 코드는 직접 붙여넣지 말고 [코드병합]으로 통합하세요. 편집기와의 정합성을 AI가 함께 검토해줍니다.

•

diff는 항상 검토 후 반영하세요. 자동 코드반영을 켜둔 경우에도, 이전 답변의 diff는 한 번씩 확인하는 습관을 권장합니다.

•

보스전은 재도전 전에 코드를 먼저 반영하세요. 같은 코드로는 재도전이 불가능합니다.

9. 예시 프롬프트

목적	예시 입력
새 전략	"고배당 + 시가총액 상위 종목으로 월 리밸런싱 전략 만들어줘"
필터 추가	"ROE 15% 이상 조건 추가해줘"
리스크 관리	"약세장 진입 시 손절선 강화하고 목표 종목 수 줄이는 로직 도입해줘"
지표 변경	"고정 손절 대신 ATR 기반 트레일링 스탑으로 변경해줘"
리밸런싱 주기 변경	"분기 리밸런싱으로 바꿔줘"
설명 요청	"setPortfolioBuilder가 어떻게 동작하는지 알려줘"
디버깅	"이 전략 수익률이 낮은 이유가 뭘까?"
현금 비중 문의	"매매 수수료랑 세금 감안했을 때 현금은 얼마나 남겨야 해?"

10. 자주 묻는 질문(FAQ)

Q. AI가 준 코드가 전략코드에 안 보여요. A. [코드반영]을 눌러야 실제로 적용됩니다. 매번 누르기 번거로우면 설정에서 자동 코드반영을 켜세요.

Q. "잘못된 API 감지"가 뜨고 자동수정 중이에요. A. 존재하지 않는 API를 자동으로 교정하는 중입니다. 완료되면 수정된 diff가 표시됩니다. 자동 교정이 불가능한 경우 "미해결"로 안내됩니다.

Q. 대화가 사라졌어요 / 압축됐어요. A. 대화가 길어지면 자동으로 요약(압축)됩니다. 내용이 사라진 것이 아니라 맥락은 유지된 채 요약된 것입니다.

Q. 사용량이 다 찼어요. A. 일일 토큰 한도이며 매일 초기화됩니다. PRO/PREMIUM 회원은 설정에서 포인트 사용을 켜면 한도 초과 후에도 계속 이용할 수 있습니다.

Q. 이전 코드 버전을 AI가 기억하나요? A. 매 요청 시 편집기에 표시된 현재 코드를 기준으로 답합니다. 과거 코드가 필요하면 코드 히스토리에서 원하는 시점으로 복원하세요.

Q. 종목이 하나도 안 뽑혀요 / 잔고보유내역이 비어요. A. [에러수정]을 눌러보세요. 흔한 원인은 (1) 필터 조건이 과도하게 엄격한 경우, (2) 이 플랫폼은 롱(매수) 전용이라 숏(공매도) 조건이 반영되지 않는 경우입니다.

Q. 보스전 재도전 버튼이 안 눌려요. A. 지난 도전과 코드가 동일하기 때문입니다. 방어 보강 요청으로 코드를 수정한 뒤 다시 도전해 보세요.

Q. 자동 코드반영을 켜면 위험하지 않나요? A. 변경 사항이 없는 응답에는 적용되지 않으며, 반영 이후에도 코드 히스토리에서 언제든 이전 시점으로 되돌릴 수 있습니다. 다만 중요한 변경은 diff를 확인하는 습관을 권장합니다.

11. 제약 사항

•

지원 전략 유형: 스크립트(코드) 전략에서만 사용할 수 있습니다. 블록(Blockly) 전략에서는 [바이브코딩] 탭 자체가 제공되지 않습니다.

•

코드 언어: 플랫폼 전용 JavaScript(ES5 스타일)만 지원합니다. let/const, 화살표 함수, 백틱 템플릿 문자열은 사용할 수 없습니다 (입력되더라도 자동 변환을 시도합니다).

•

사용 가능 함수: iQ 스튜디오 플랫폼에서 제공하는 API로만 한정됩니다. 외부 라이브러리는 사용할 수 없습니다.

•

롱(매수) 전용: 공매도(숏)는 지원하지 않습니다. 하락에 베팅하는 전략은 구성할 수 없습니다.

•

금액·단위 주의: 함수마다 반환 단위가 다릅니다 (예: 시가총액·거래대금은 백만원 단위, 일부 재무 지표는 천원 단위). 코드 검토 시 단위를 함께 확인하세요.

•

현금 비중: 매매 수수료·거래세, 그리고 종목 교체 시 매도금액과 매수금액의 시차로 인한 차이를 감안해, 자산 비중 설계 시 일반적으로 현금 비중을 일정 수준 이상 남겨두는 것이 안전합니다.

•

Beta 상태: 기능과 사용 한도는 서비스 개선 과정에서 변경될 수 있습니다. AI가 생성한 코드와 결과는 반드시 검토 후 사용하세요.