Whale — 모든 환경에서 사용 가능한 DeepSeek용 AI 코딩 에이전트

简体中文 · English

매우 빠른 속도 · ~98% 프롬프트 캐시 히트 (prompt cache hit) · 불필요한 기능 없음 (Zero bloat)

Whale — 모든 환경에서 사용 가능한 DeepSeek용 AI 코딩 에이전트 (AI coding agent).

긴 컨텍스트 (Long context), 도구 (tools), 그리고 프로그래밍 가능한 워크플로우 (programmable workflows) —

터미널에서 시작하여 데스크톱 및 그 이상으로 확장하세요.

모든 플랫폼:

npm install -g @usewhale/whale

macOS:

brew install usewhale/tap/whale

Linux:

curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh

Windows PowerShell:

Windows 10 또는 Windows Server 2016 이상이 필요합니다.

irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex"

# DeepSeek API 키 설정
whale setup
# 대화형 TUI 실행
...

끝입니다. 질문을 입력하면 Whale이 파일 읽기, 명령 실행, 코드 편집, 웹 검색 등을 시작하며 작동합니다.

다른 모델 제공자 (model provider), 프록시 (proxy) 또는 사용자 정의 설정 (custom config)이 필요하신가요? 설정 (Configuration) 섹션을 참조하세요.

항목	중요성
💰 ~98% 프롬프트 캐시 히트 (prompt cache hit)	Whale은 캐시된 컨텍스트 (cached context)를 공격적으로 재사용합니다. 대부분의 프롬프트가 캐시에 적중하여 세션당 비용을 몇 푼 수준으로 절감합니다. DeepSeek 가격 × Whale 캐싱 = 대규모 AI 지원 코딩.
🐋 DeepSeek 네이티브 (DeepSeek-native)	DeepSeek의 긴 컨텍스트 (1M tokens), 도구 호출 (tool calling), 비용 효율성에 맞춰 구축되었습니다. 일반적인 멀티 모델 래퍼 (multi-model wrapper)가 아닙니다.
🔁 동적 워크플로우 (Dynamic Workflows)	여러 에이전트 (agents)를 오케스트레이션하는 JavaScript 스크립트를 작성하세요 — 팬아웃(fan-out) 조사, 다각도 리뷰, 파이프라인 등. Claude Code와 호환됩니다.
🔌 MCP	1,000개 이상의 MCP 서버를 연결하여 확장된 도구 기능을 사용하세요 — 파일 작업, 셸 (shell), git, 웹 등.
🧩 기술 + 플러그인 (Skills + Plugins)	커뮤니티 기술 (코드 리뷰, git 워크플로우 등)을 설치하거나 직접 작성하세요.

Whale의 **동적 워크플로우 (Dynamic Workflows)**를 사용하면 JavaScript로 멀티 에이전트 오케스트레이션을 스크립트로 작성할 수 있습니다:

// .whale/workflows/research.js
const results = await parallel([
() => agent("Go 에러 처리의 베스트 프랙티스 검색"),
...

Fan-out research (분산 조사) · Multi-perspective review (다각도 검토) · Pipeline processing (파이프라인 처리) · Adversarial validation (적대적 검증)

✅

Claude Code 호환 — Claude Code를 위해 작성된 워크플로우 스크립트가 Whale에서도 그대로 작동합니다.

— 실행 방법: TUI에서 ⚠️ 기본적으로 비활성화됨/config

를 실행하여 Dynamic workflows (동적 워크플로우)를 활성화하거나, .whale/config.local.toml 파일에 [workflows] enabled = true를 추가하세요.

더 알아보기: Workflow Overview (워크플로우 개요) · Custom Workflow Guide (커스텀 워크플로우 가이드)

확장 기능 (Extension)	기능	시작하기
MCP Servers	1,000개 이상의 도구(데이터베이스, API, 브라우저 자동화)에 연결	docs/mcp.en.md
Skills	도메인 전문 지식 로드 — 코드 리뷰, git-worktree 등	docs/skills.en.md
Subagents	리뷰어 또는 연구원과 같이 집중된 하위 에이전트 역할 정의	docs/agents.en.md
Plugins	커스텀 로직으로 Whale의 런타임 확장	docs/plugins.en.md
Hooks	라이프사이클 이벤트 발생 시 스크립트 실행	docs/hooks.en.md

Whale은 현재 세 가지 인터페이스를 제공하며, 더 많은 환경이 추가될 예정입니다:

인터페이스	사용 시점
(TUI) whale	대화형 코딩 세션 — 전체 컨텍스트를 바탕으로 채팅, 리뷰, 반복 작업
(CLI) whale ask "..."	단발성 질문, 빠른 코드 리뷰, 단일 명령
whale --headless	CI/CD, 자동화된 PR 리뷰, 예약된 작업

멀티 모델 셸 (Multi-model shell). Whale은 DeepSeek 우선(DeepSeek-first) 방식으로 설계되었습니다 — DeepSeek의 캐싱, 도구 및 가격 정책에 최적화되어 있습니다. IDE 대체제. Whale은 IDE가 아닙니다 — 터미널, 데스크톱 또는 CI 등 당신이 코딩하는 모든 곳에서 함께하는 에이전트입니다.

Whale은 활발히 개발 중입니다. 개인 프로젝트, 실험적 저장소, 그리고 변경 사항을 검토하고 롤백할 수 있는 워크플로우에 가장 적합합니다.

면책 조항 (Disclaimer): 이 프로젝트는 DeepSeek Inc.와 관련이 없습니다. 이는 독립적인 오픈 소스 커뮤니티 프로젝트입니다.

로컬 개발, 테스트, 이슈 및 PR에 대해서는 CONTRIBUTING.md를 참조하세요.

현재 방향 및 가능한 작업: ROADMAP.md.

보안 이슈: SECURITY.md.

Whale은 거인들의 어깨 위에 서 있습니다:

• Charmbracelet — Bubble Tea, Lip Gloss, Glamour, 그리고 전체 TUI (Terminal User Interface) 생태계
• fastschema/qjs — 워크플로우 스크립팅을 위한 QuickJS Go 바인딩 (bindings)
• spf13/cobra — CLI (Command Line Interface) 프레임워크
• alecthomas/chroma — 구문 강조 (Syntax highlighting)
• yuin/goldmark — Markdown 파싱 (parsing)
• modelcontextprotocol/go-sdk — MCP (Model Context Protocol) 프로토콜 지원
• tetratelabs/wazero — Pure-Go WebAssembly 런타임 (runtime)

그리고 우리가 의존하고 있는 수많은 오픈 소스 라이브러리들 — 감사합니다.