2026-08-13자
v0.9.5
Codewhale어떤 모델이든, 당신의 머신에서
★ 40.7k
오픈 소스 · 원하는 모델을 그대로 · 터미널에서 실행

깊은 곳으로 대신 잠수하고,
당신은 잠수하지 않아도 됩니다.

Codewhale은 터미널을 위한 오픈 소스 코딩 에이전트입니다. 모델과 작업을 주면 코드를 읽고, 파일을 고치고, 스스로 검사를 실행한 뒤 작업이 끝났거나 당신이 필요할 때 멈춥니다. 어떤 모델이든 가져올 수 있고 섞어 쓸 수도 있습니다 — 역할마다 다른 모델을 지정하세요.

설치 문서 GitHub
한 줄 설치
npm install -g codewhale
Node 18+ 필요 — Rust 툴체인은 필요 없음다른 방법 →

cw최신 릴리스 v0.9.6현재 소스 v0.9.6프로바이더 경로 40개MIT

Codewhale TUI현재 세션
Operate 모드, 고래, 입력창, 하단 바가 보이는 현재 Codewhale 터미널 세션
현재 Codewhale 세션 · Operate 모드 · Ask 권한 상태
실시간LIVE
열림#5343test(release): tolerate shared-runner route latency@Hmbown 님1시간 전병합됨#5341chore(release): prepare v0.9.7@Hmbown 님2시간 전열림#5342fix(tui): restore bounded Auto-Review execution@Hmbown 님2시간 전닫힘#5320fix(session): separate snapshot reads from crash recovery@h3c-hexin 님19시간 전병합됨#5330fix(session): separate snapshot reads from crash recovery@Hmbown 님19시간 전열림#5336fix(mcp): omit nextCursor when there are no further pages@xiaoray-blip 님19시간 전열림#5334docs(i18n): retire the stale zh-Hant partial-pack declaration@Lstarsky0 님19시간 전닫힘#5321feat: register OrcaRouter as a named provider@XiaoHuo888-hue 님20시간 전병합됨#5332feat(config): register OrcaRouter as a named provider@Hmbown 님20시간 전닫힘#5319fix(tui): copy messages without visual rails@XhesicaFrost 님20시간 전병합됨#5331fix(tui): copy messages without visual rails@Hmbown 님20시간 전열림#5333feat(tui): pin host terminal window as an always-on-top mini window@Hmbown 님21시간 전병합됨#5329fix(tui): move lru to 0.18 and unpin ratatui-core (RUSTSEC-2026-0253)@Hmbown 님22시간 전닫힘#5327feat(tui): add interactive extensions manager@Inference1 님23시간 전릴리스v0.9.6어제열림#5328FEAT-014: Command contract crate boundary (facets + shared types) for …@aboimpinto 님어제열림#5326web: audit fixes — i18n parity, copy/spacing, test fixes@Hmbown 님어제열림#5318feat(tui): pin host terminal window as an always-on-top mini window@SparkofSpike 님그저께

수중 터미널 셸. 어떤 모델이든. 당신의 머신에서.

이미 쓰고 있는 모델을 그대로 가져오세요 — 호스팅형이든, 게이트웨이든, 로컬이든. Plan / Act / Operate와 명시적인 권한 상태가 잠수를 당신의 통제 아래에 둡니다.

판단 과정 보기

추론 기록에서 확인되는 규칙

실제 세션 발췌 — 우선순위가 매겨진 프로젝트 규칙이 랜딩 페이지 주장이 아니라 모델 추론 속에서 드러납니다.

codewhale — thinking
추론 기록
# When the prior session's summary didn't match the repo…
› Per Article II (truth) and V (verification), I report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
→ Reported the uncommitted work the summary left out, instead of repeating the claim.
›

작업에서 검증된 변경까지.

  1. 01

    조사

    저장소와 지침, 그리고 작업 내용을 읽습니다.

  2. 02

    실행

    명시적인 승인 경계 안에서 파일을 수정합니다.

  3. 03

    검증

    검사를 실행하고 결과를 확인합니다.

  4. 04

    보고

    간결하고 오래 남는 기록을 남깁니다.

$ codewhale exec "fix the failing test"inspect   저장소와 지침act       선택한 권한 상태 안에서 수정verify    cargo test --lockedreport    검사 통과 · 기록 저장됨

Codewhale이 처음인가요? 네 단계면 끝입니다.

설치 → 키 없는 첫 세션 → 프로바이더 연결 → 첫 Fleet 워크플로. 용어는 용어 페이지에 정의되어 있습니다.

  1. Install Codewhale

    One npm command installs the dispatcher and terminal runtime. Cargo, archives, Docker, Nix, and China mirrors are documented alternatives — published releases only.

    npm install -g codewhale
codewhale doctor
    Full install guide →

  2. Open a first session — no key needed

    Launches without any API key: short constitution-first setup, then the full interface. Explore in Plan mode — always read-only. Model replies need a provider; that's the next step.

    codewhale
    Learn the product nouns first →

  3. Connect a provider

    Pick a supported route — hosted key, gateway, or keyless local runtime (Ollama, vLLM, SGLang). Provider and model stay explicit; reasoning and routing provenance stay separate, and unavailable values stay unavailable.

    codewhale auth set --provider deepseek
    Providers and models →

  4. Run a first Fleet workflow

    For durable workers, ordered phases, or receipts, author a reusable agent-team profile and launch a run. Fleet state lives in the workspace ledger; ordinary single tasks need none of this.

    codewhale fleet init
codewhale fleet run tasks.json --max-workers 4
    Fleet and Workflow docs →
시작 가이드 읽기 →제품 용어 보기 →

당신의 모델.
당신의 경계.

모델과 작업 모드, 권한 상태를 직접 고르세요. 알 수 없는 비용은 알 수 없다고 밝히고, 미리보기 단계의 기능은 그대로 미리보기라고 표시합니다.

프로바이더 경로 40개
호스팅형, 게이트웨이, 로컬 모델
Plan · Act · Operate
읽기 전용 계획부터 자율 실행까지
Ask · Auto-Review · Full Access
작업에 맞는 권한 상태 선택
TUI · exec · web · API
대화형과 헤드리스 런타임 인터페이스

작업이 일어나는 자리에서 런타임을 사용하세요.

TUI대화형 터미널 작업
codewhale exec스크립트와 CI
웹 클라이언트루프백 전용 브라우저 클라이언트
Runtime API + MCP로컬 통합
Fleet지속형 멀티 에이전트 작업
런타임 인터페이스와 안정성 노트 보기 →

명령 하나로 시작하세요.

npm install -g codewhale

Cargo바이너리DockerNixWindowsAndroid / Termux중국 미러

설치 가이드 읽기 →

공개적으로 개발합니다

MIT 라이선스로 공개되어 있으며, 런타임과 프로바이더, 플랫폼, 문서, 테스트 전반의 기여자들이 함께 만들어 갑니다.