모든 모델과 함께 작동하는 오픈소스 코딩 에이전트

모든 모델과 함께 작동하는 오픈소스 코딩 에이전트.

Codewhale은 사용자의 프로젝트를 읽고, 파일을 편집하며, 명령을 실행하고, 자신의 작업을 검사합니다. 이는 선택한 호스팅 또는 로컬 모델을 사용하여 터미널에서 이루어집니다.

Website · Documentation · Changelog · Contributing

简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

A Codewhale terminal session

새로 설치한 터미널 화면을 실제로 캡처한 것입니다. 스테이징된 출력은 없습니다.

macOS 및 Linux:

curl -fsSL https://codewhale.net/install.sh | sh

설치 프로그램은 검증된 체크섬 바이너리를 ~/.local/bin에 다운로드합니다.

만약 codewhale을 실행했을 때

네이티브 데스크톱 앱(GPUI)이 로그인된 제품 클라이언트로 구축되고 있습니다. 사용 가능 여부는 제품 페이지를 참조하세요. 커뮤니티에서 관리하는 VS Code 확장 프로그램은 사이드바에서 동일한 엔진에 연결합니다 (출처).

어떤 모델과도 작동하며, 종속성이 없습니다. Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI 등 40개 이상의 내장 제공업체 경로와 모든 OpenAI 호환 엔드포인트 및 Ollama, vLLM 또는 SGLang을 통한 로컬 모델을 지원합니다. 제어권을 유지하세요. 계획(Plan) 모드는 아무것도 변경하지 않고 탐색하며, 작업(Work)과 운영(Operate)은 변경 사항을 만듭니다. 승인 자세(Approval postures)는 도구 호출에 귀하의 확인이 필요한 시점을 결정합니다. /undo 및 /restore로 워크스페이스 변경 사항을 복구하고, /receipts로 세션 내 모든 파일, 명령어 및 승인을 나열합니다. 모드 · 기록 장기 작업에 최적화. 영속적인 /goal을 설정하거나, 하위 에이전트에게 제한된 작업을 위임하고, 사전 지출 확인(pre-spend check)을 통해 감독되는 에이전트 팀을 실행하거나, 검증된 워크플로우로 스크립팅할 수 있습니다. 기존 사용 기능을 확장하세요. MCP 서버에 연결하고, 기술 및 플러그인을 설치하며, 세션 및 도구 이벤트에 대한 후크를 실행하고, 기존 Claude Code 플러그인을 로드합니다. 컴퓨터 사용. 포함된 플러그인은 다른 애플리케이션을 관찰하고 조작하는 도구를 추가합니다. 사용 전에 접근 권한을 검토하고 활성화하세요. 가이드

| 선택 기준 | 옵션 | |
|---|---|
모드 — 에이전트가 수행하는 작업 | Tab 또는 /mode | 계획(Plan) (탐색, 변경 없음) · 작업(Work) (편집 및 실행) · 운영(Operate) (계획되고 검증된 단계를 통해 목표 추진) |
자세(Posture) — 먼저 요청하는 시점 | Shift+Tab | 질문(Ask) · 자동 검토(Auto-Review) · 전체 접근(Full Access) |

전체 접근은 여전히 하드 정책 경계를 존중합니다. 모드 및 권한 가이드에서 각 옵션을 설명합니다.

Codewhale은 사용자가 허가하는 접근 권한으로 기기에서 실행됩니다. 승인 정책(Approval postures)과 리포지토리 규칙이 에이전트가 수행할 수 있는 작업을 제한하며, 지원되는 경우 OS 샌드박스 내에서 명령을 실행합니다(macOS의 Seatbelt; Linux의 bubblewrap은 선택 사항). /preview-request는 어떤 것이 전송되기 전에 정확히 마스킹된 요청을 보여줍니다. 알 수 없는 모델 가격은 무료로 보고되는 대신 계속 알 수 없는 상태를 유지합니다.

권한 부여 순서(authorization order), 샌드박싱, 원격 측정(telemetry)에 대해 알아보세요. 사용량 카운트는 기본적으로 활성화되어 있으며 codewhale config set telemetry false 명령으로 끌 수 있습니다.

Discord에 참여하거나 WeChat에서 Hunter(hunterbown)에게 추가하여 Whale Brothers 그룹 가입을 요청하세요.

Codewhale은 deepseek-tui로 시작했으며 여전히 해당 프로젝트의 구성 및 세션을 읽습니다. 이제는 제공업체 중립적이며 독립적으로 유지 관리되고 있으며, 어떤 모델 제공업체와도 제휴하지 않습니다. 모든 기여자들과 성장에 도움을 준 오픈 소스 커뮤니티에 감사드립니다.

MIT. 다른 오픈 소스 프로젝트에서 각색된 부분은 타사 공지사항(third-party notices)에 기록되어 있습니다.