Blave Agent

AI 에이전트를 위한 양자 워크스페이스 (Quant Workspace for AI Agents)

Claude Code 또는 Codex를 사용하여 전략을 구축하고, 백테스트하며, 실시간으로 거래할 수 있습니다. 무료이며 오픈 소스입니다.

English | 繁體中文 | 简体中文 | 日本語 | Español | Português | Tiếng Việt

Platform: macOS | Windows

macOS용 다운로드 · Windows용 다운로드 · 빠른 시작 · 컴퓨터가 꺼진 상태에서 실행하기

이 저장소가 유용하다면 별점을 눌러주시고, 새 버전에 대한 알림을 받으려면 Watch › Releases를 확인하세요.

차별화된 점 (What Makes It Different)

Claude Code 또는 Codex는 거래 봇을 작성할 수 있습니다. 하지만 실제로 실행하는 것이 어려운 부분입니다. 터미널에서 모든 전략은 스크립트 폴더와 채팅 로그로 구성되며, 몇 개를 넘어서면 추적하기 어렵습니다. 자체 자동 거래 시스템을 구축하려면 스케줄링, 거래소 API, 포지션 조정(position reconciliation), 재시작, 키 등을 직접 처리해야 합니다. Blave Agent는 바로 이 빠진 부분입니다.

하나의 앱에 모인 전략들, 흩어진 스크립트가 아닙니다

각 전략은 사이드바에 백테스트, 거래 내역, 파라미터 스캔, 아웃-오브-샘플 테스트(out-of-sample test), 코드 및 저장된 버전과 함께 위치합니다. 목록에서 이전 버전을 복원하고 포트폴리오 페이지에서 각 전략이 얼마나 거래할지 설정할 수 있습니다.

이미 연결된 자동 거래 기능 (Auto-Trading Already Wired Up)

• 거래소 연결: Windows에서 Binance, OKX, Bybit, BingX, Gate.io 또는 President Futures를 연결할 수 있습니다. 키는 먼저 거래소에서 확인해야 하며, 출금 가능한 키가 아닌 경우 거부됩니다 (Gate.io는 이를 보고하지 않으므로 직접 확인하세요).
• 금액 설정 후 '거래 시작'을 누르세요. 앱은 각 전략을 예약된 시간에 실행하고 계좌를 목표 포지션으로 이동시킵니다. 모든 주문 시도는 기록됩니다 (state/audit.jsonl).
• 메뉴 표시줄(Windows의 시스템 트레이)에서 **거래 일시 중지 (포지션 유지)**할 수 있습니다. 앱을 종료했다가 다시 열어도, '거래 시작' 버튼을 다시 누르기 전까지는 아무것도 거래되지 않습니다.
• **모의 거래(Paper trading)**에는 키가 필요하지 않습니다.

과적합 검사 및 실제 수수료를 사용하는 백테스트

과적합 (Overfitting): 과거 데이터에 우연히 맞는 매개변수.

• 모든 Type A 백테스트에서 MCPT p-value (lib/validation.py): 셔플된 데이터도 이만큼 잘했을까?
• 단일 최적 셀이 아닌 평탄부를 위한 매개변수 스캔 (Parameter scan) (lib/param_scan.py); 샘플 외부 결과를 위한 워크 포워드(walk-forward) (lib/walk_forward.py).
• 실제 수수료: 수수료가 0인 경우 경고가 발생합니다 (lib/quality_check.py).
• 하나의 아이디어, 하나의 백테스트: 나쁜 결과는 조용히 재조정되지 않고 있는 그대로 보고됩니다 (반복 브레이크 in AGENTS.md).

아이디어가 없나요? 웹에서 검색해 드립니다

**'아이디어를 위해 웹 검색'**을 누르면 에이전트가 수십 개의 사이트를 읽은 다음, 진입 및 청산 규칙과 출처 URL이 포함된 세 가지 백테스트 가능한 아이디어를 가져옵니다. 하나를 선택하면 이를 구축하고 백테스트합니다. 앱 내장 브라우저에서 페이지를 열어 사용자 화면에 표시하며, 거래소 계정 페이지와 사설 네트워크 주소는 차단됩니다.

<a id="quick-start"></a>

빠른 시작 (Quick Start)

macOS 또는 Windows (macOS 13 이상, 또는 Windows 10/11 x64)용 앱을 다운로드하여 열어주세요.

최초 실행 시 에이전트의 동력을 무엇으로 할지 선택합니다:

• 사용자 자체 Claude Code 또는 Codex. Blave 계정이 필요하지 않습니다. Blave는 AI 사용에 대해 비용을 청구하지 않습니다.
• 사용자 자체 DeepSeek 키. DeepSeek이 직접 사용자에게 청구합니다. 이 키는 컴퓨터의 키체인에 저장되며 에이전트에게 전달되지 않습니다.
• Blave AI. Blave 계정으로 로그인하고, 사용량 기반으로 비용을 지불합니다.

다음 아이디어를 설명해 보세요:

• "4시간 차트에서 BTCUSDT를 백테스트(backtest)하세요: 20기간 SMA가 60기간 SMA를 상향 돌파할 때 롱(long), 다시 하향 돌파하면 플랫(flat). 거래 수수료는 편당 0.05%를 사용합니다."
• "해당 전략의 모든 SMA 길이에 대해 스캔하여 어느 지점에서 평탄화(plateau)되는지 보여주세요."

에이전트는 코드를 작성하기 전에 모든 아이디어를 세 가지 유형 중 하나로 분류합니다:

• 패키징된 macOS 앱은 유니버설 빌드(Apple Silicon 및 Intel)입니다. Windows: Electron 44가 지원하는 버전이며, ARM은 테스트되지 않았습니다. Windows 설치 프로그램은 아직 코드 서명(code-signed)이 되어 있지 않아 첫 설치 시 SmartScreen 경고가 표시될 수 있습니다: '자세히' > '사용해도 계속'을 선택하세요.
• Node.js 버전: shell/package.json › engines. 패키징된 앱은 자체 Python 3.12를 번들링합니다. 소스에서 실행하는 경우 시스템의 Python(python3, 또는 Windows에서는 python)을 사용하여 venv를 생성합니다.
• Codex는 ChatGPT 앱 내에 포함됩니다 — Windows용 Microsoft Store의 “ChatGPT” (winget install --id 9PLM9XGG6VKS -s msstore), Mac용 ChatGPT.app. Windows에서는 현재 npm @openai/codex 0.161–0.162.1 빌드는 피하세요 (샌드박스가 손상되었습니다).
• 사용자 자체 Claude Code 또는 Codex를 사용하는 경우, 앱은 CLI만 실행하며 사용자의 자격 증명(credentials)은 그곳에 남아 있습니다. DeepSeek 키는 Windows에서 암호화되어 저장되며, 앱이 에이전트의 요청을 로컬로 중계합니다.
• npm.cmd는 PowerShell의 실행 정책이 npm 스크립트를 차단하더라도 실행됩니다.
• 인터페이스는 시스템 언어(영어 또는 전통 중국어)를 따릅니다. 재정의하려면: BLAVE_LANG=en npm start (PowerShell: $env:BLAVE_LANG="en"; npm.cmd start).

소스에서 가져옴

macOS 13 이상 또는 Windows 10/11 (x64), PATH에 Python 3, 그리고 다음 중 하나가 필요합니다: Claude Code 또는 Codex 로그인, DeepSeek API 키, 또는 Blave 계정.

git clone https://github.com/Blave-TW/blave-agent.git
cd blave-agent/shell
npm install
...

Windows에서는 PowerShell에서 npm.cmd install 및 npm.cmd start를 실행합니다.

뉴스

각 버전별 변경 사항: 릴리스.

거래소 및 데이터

테스트된 주문 라이브러리를 갖춘 거래소 (lib/account_*.py + lib/order_*.py, 실제 계정에서 검증됨):

• Binance, BingX, OKX, Gate.io, Bybit — 선물 및 현물
• Capital Futures (群益期貨) — 대만 지수 선물(TXF, MXF 및 TMF); Windows 클라우드 머신 전용 (API가 Windows COM 구성 요소이므로 references/capital-broker.md 참조) — 데스크톱 앱으로는 어떤 OS에서도 연결할 수 없습니다. 앱에서 인증서를 업로드하면 에이전트가 클라우드 머신에서 설정을 완료합니다 — 원격 데스크톱 불필요.
• President Futures (統一期貨) — TXF, MXF 및 TMF; Windows 전용, 왜냐하면 인증서 도구가 Windows 10 이상에서만 실행되기 때문입니다 ( references/president-broker.md 참조). Windows 데스크톱 앱에서는 인증서를 업로드하고 앱 내에서 로그인합니다. Windows 클라우드 머신에서는 본인의 Windows PC에서 인증서를 신청하거나 내보낸 다음, 웹 워크스페이스의 자동 거래 페이지에 업로드하고 그곳에서 로그인을 확인합니다 — 원격 데스크톱 불필요.

거래소 연결 방식은 에이전트가 실행되는 위치에 따라 달라집니다:

• 데스크톱 앱: Binance, OKX, BingX, Gate.io 및 Bybit은 앱의 '자동 거래(Auto trading) › 거래소 연결(Connect an exchange)' 섹션에서 연결되며, 이 과정에서 키가 먼저 거래소와 확인됩니다. 채팅에 붙여넣은 키는 거부되므로 대신 '거래소 연결'을 사용해야 합니다. 붙여넣은 모든 내용은 채팅 기록에 남아 있으니 실수로 붙여넣은 키는 반드시 교체하세요. Type C 전략(여러 심볼을 가중치 벡터로 보유하는 하나의 전략 — 포트폴리오 페이지가 각 전략의 금액을 설정하는 곳이 아님)은 데스크톱 앱에서 자동 거래할 수 있습니다. 만약 워크스페이스 라이브러리(lib)가 이들을 거래하기에 너무 오래되었다면, 업데이트될 때까지 '선택된 전략(Pick strategies)'에서 잠긴 상태로 표시됩니다. 계약 또는 주식으로 크기가 지정된 Type C 전략은 주문을 넣지 않으며, Type C는 President Futures나 Capital Futures로 라우팅할 수 없습니다 — 여기에 금액을 할당하는 것은 거부됩니다.
• 클라우드 머신: 웹 워크스페이스의 '자동 거래(Auto trading)' 페이지에서 거래소를 바인딩하거나, Binance, BingX, OKX, Gate.io 또는 Bybit 키를 채팅에 붙여넣으면 에이전트가 lib.venue.bind로 이를 바인딩합니다.

다른 API를 가진 모든 거래소나 브로커의 경우, 에이전트는 lib/account_TEMPLATE.py와 lib/order_TEMPLATE.py에서 헬퍼(helper) 코드를 작성할 수 있습니다. 이 코드는 Blave에 의해 테스트되지 않았습니다.

**모의 거래(Paper trading)**는 키가 필요하지 않습니다. 이는 lib/account_paper.py + lib/order_paper.py로 배포되며, 전략 자체의 데이터 소스(lib/paper_data.py)에서 가장 최근 종가를 가져와 채웁니다.

데이터.

• 데스크톱 앱은 계정이 필요 없습니다: Binance의 암호화폐 klines (USDT-M 무기한 계약, 모든 간격, 상장 시점부터) 및 BingX 공개 엔드포인트; TWSE와 TPEx에서 거래소 자체 배당 조정이 적용된 대만 주식 일별 봉(2010년부터 상장, 1990년대부터 OTC); TAIFEX 공개 데이터의 대만 지수 선물 일별 봉(1998년 이후); TWSE의 시장 전체 기관 순매수(2004년 이후 외국인 투자자); 미국 주식 및 ETF 일별 봉(백테스트 전용, 자동 거래 불가); 암호화폐 공포 & 탐욕 지수(2018년 이후). Blave의 지표, 대만 장중 및 종목별 흐름 데이터, 선물 장중 봉 및 나머지 선물 데이터, 그리고 거시 경제 캘린더는 데이터 접근을 위해 Blave 계정이 필요합니다.
• 클라우드 머신: 시장 데이터는 lib/data.py를 통해 Blave API에서 가져옵니다 — 암호화폐 klines와 지표, 대만 주식, 선물.

안전 및 제한 사항

• 키(Keys): 읽기 및 거래 권한만 부여해야 합니다. 출금 권한이 있는 키는 연결 시 거부됩니다 (Binance, OKX, BingX, Bybit); Gate.io는 이 플래그를 보고하지 않으므로 직접 확인해야 합니다. 키는 사용자의 컴퓨터의 워크스페이스 .env 파일(~/Blave/workspace/.env, Windows에서는 %USERPROFILE%lave amespace\.env) 또는 자체 클라우드 머신에, 혹은 웹 페이지에서 바인딩될 때 Blave에 의해 암호화되어 저장됩니다. 에이전트는 이 .env 파일을 읽을 수 있지만, 규칙상 키 값을 출력하는 것은 금지되어 있습니다 (references/exchange-connect.md).
• 사용자가 자금을 지원하고 거래를 재개합니다. 데스크톱 앱의 자동 거래 페이지 또는 웹 워크스페이스에서 합니다. 에이전트는 요청받더라도 거부하며, 스스로 할 수 있는 유일한 일은 비상 정지 스위치(kill switch)를 작동시키는 것입니다.
• 데스크톱 주문은 Blave가 실행 중일 때만 전송됩니다. 종료했다가 다시 열면, '거래 시작(Start trading)'을 누르기 전까지 거래는 일시 중단 상태로 유지됩니다.
• 보고 전에 검증: 에이전트가 주문을 넣었다고 말하기 전에 거래소로부터 해당 주문에 대한 질의 응답이 이루어지며, 모든 시도는 state/audit.jsonl에 기록됩니다.
• 백테스트는 과거를 설명합니다.

MCPT 및 파라미터 스캔은 운이 작용했을 가능성을 낮출 뿐, 완전히 제거하지는 않습니다. 여기에 있는 내용은 투자 조언이 아니며, 트레이딩을 하다가는 모든 돈을 잃을 수 있습니다.

클라우드에서 실행하기 (유료)

컴퓨터를 꺼둔 상태에서도 전략을 계속 실행하려면, Blave Agent가 전용 클라우드 머신에서 동일한 워크스페이스를 실행합니다. 웹 워크스페이스나 Telegram(SSH도 가능)으로 접속하거나, 리포트를 예약하거나, 사용자의 Claude Code, Codex 또는 다른 MCP 에이전트(연결 가이드)를 연결할 수 있습니다. 플랜 및 가격: blave.org/agent/en.

코드만 읽기

1. AGENTS.md — 에이전트가 작동해야 하는 방식
2. examples/README.md — 8가지 완전한 전략으로, 각각 하나의 패턴을 보여줍니다.
3. references/lib.md 및 references/strategy-code.md — 라이브러리 시그니처와 전략 코드 규칙
4. strategies/TEMPLATE_A.py 및 strategies/TEMPLATE_C.py

openclaw 이름에 대하여: 이것은 이전 프레임워크의 이름입니다. 설정 파일(openclaw.json), API 경로(/openclaw/...) 및 SSH 호스트 이름에는 여전히 이 이름이 남아 있는데, 이는 해당 위치가 실제로 그렇게 불리기 때문입니다. runtime/의 런타임은 2026-07-25부터 자체적으로 운영되어 왔으며 해당 제품과는 관련이 없습니다.

소스에서 실행하기: 무엇이 어디에 들어가는지

처음 연결할 때, 앱은 ~/Blave/ (Windows의 경우 %USERPROFILE%lave ext{)를 준비합니다: