터미널에서 실행하는 오픈소스 AI 코딩 에이전트로, 데스크톱·웹·에디터·채팅 인터페이스도 제공합니다.
codewhale-hq/Codewhale
파일 편집과 명령 실행을 지원하고 로컬 모델을 포함한 40개 이상의 모델 제공업체와 연동되는 오픈소스 Rust 터미널 코딩 에이전트입니다.
대체할 수 있는 제품:Claude Code
Cursor
- 스타
- 41,103
- 포크
- 3,570
- 열린 이슈
- 205
- 마지막 커밋
- 17시간 전
어떤 프로젝트인가요?
Codewhale은 터미널에서 실행되는 코딩 에이전트입니다. 작업을 전달하면 저장소를 살펴보고, 파일을 수정하고, 작업을 완료하거나 사용자 입력이 필요할 때까지 셸 명령을 실행합니다. Anthropic, OpenAI, DeepSeek, Google, Mistral, OpenRouter를 포함해 40개 이상의 제공업체를 기본 지원하며, OpenAI 호환 엔드포인트나 Ollama, vLLM, SGLang으로 제공되는 로컬 모델도 사용할 수 있습니다.
기본적으로 읽기 전용이 아닌 셸 명령을 실행하기 전에는 승인을 요청합니다. 두 가지 모드(Plan, Work, Operate)와 세 가지 권한 수준(Ask, Auto-Review, Full Access)으로 에이전트가 자율적으로 수행할 수 있는 작업 범위를 조절할 수 있습니다. /receipts 명령은 변경된 파일, 실행한 명령, 웹 및 MCP 호출을 나열하고, /undo는 마지막 요청에서 변경된 파일을 되돌립니다.
동일한 엔진으로 대화형 터미널 앱, 스크립트와 CI용 비대화형 exec 모드, 로컬 웹 UI, PR 리뷰 명령, 로컬 HTTP Runtime API, 에디터용 Agent Client Protocol 서버를 제공합니다. MCP 서버, skills, plugins, hooks도 지원합니다.
핵심 기능
- 0140개 이상의 기본 제공 모델 제공업체 및 모든 OpenAI 호환 엔드포인트와 연동
- 02Ollama, vLLM, SGLang을 통한 로컬 모델 지원
- 03읽기 전용이 아닌 셸 명령 실행 전에 승인을 요청하며, Ask, Auto-Review, Full Access 권한 수준 제공
- 04변경된 파일, 실행한 명령, 외부 호출 내역 기록
- 05/undo로 마지막 요청에서 변경된 파일 되돌리기
- 06MCP 서버, skills, plugins, hooks 연결
활용 사례
- 터미널에서 git 저장소의 실패하는 테스트를 수정하거나 여러 파일을 변경
- codewhale exec를 사용해 스크립트나 CI에서 코딩 작업을 비대화형으로 실행
- 검토 의견을 제공하는 리뷰 명령으로 GitHub pull request 검토
- 코드를 로컬 장비에 유지하면서 호스팅된 로컬 모델 사용
빠른 시작
- 1
README의 공식 설치 스크립트로 설치하기
- 2
npm으로 설치하기
npm install -g codewhale - 3
git 저장소의 루트에서 codewhale 실행하기
codewhale - 4
/provider를 실행해 provider를 선택하고 API 키를 붙여넣은 다음 작업 입력하기
사용 전 알아둘 점
- Windows에서는 아직 OS 샌드박스를 사용할 수 없으며, Full Access를 켜면 샌드박스가 비활성화됩니다.
- 텔레메트리는 기본적으로 켜져 있으며 config 명령으로 끌 수 있습니다.
- 번들로 제공되는 Computer Use 플러그인은 실험 단계이며 macOS에서만 사용할 수 있습니다.
- 일부 기능은 main에 병합되었지만 아직 정식 릴리스에는 포함되지 않았습니다.
토픽
자주 묻는 질문
- Codewhale은(는) 무엇인가요?
- 파일 편집과 명령 실행을 지원하고 로컬 모델을 포함한 40개 이상의 모델 제공업체와 연동되는 오픈소스 Rust 터미널 코딩 에이전트입니다. Codewhale은 터미널에서 실행되는 코딩 에이전트입니다. 작업을 전달하면 저장소를 살펴보고, 파일을 수정하고, 작업을 완료하거나 사용자 입력이 필요할 때까지 셸 명령을 실행합니다. Anthropic, OpenAI, DeepSeek, Google, Mistral, OpenRouter를 포함해 40개 이상의 제공업체를 기본 지원하며, OpenAI 호환 엔드포인트나 Ollama, vLLM, SGLang으로 제공되는 로컬 모델도 사용할 수 있습니다.
- Codewhale은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- Codewhale은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- Codewhale은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. Codewhale의 마지막 커밋은 2026년 10월 19일입니다.
- Codewhale은(는) 어디에 사용할 수 있나요?
- 터미널에서 git 저장소의 실패하는 테스트를 수정하거나 여러 파일을 변경 codewhale exec를 사용해 스크립트나 CI에서 코딩 작업을 비대화형으로 실행 검토 의견을 제공하는 리뷰 명령으로 GitHub pull request 검토 코드를 로컬 장비에 유지하면서 호스팅된 로컬 모델 사용
- Codewhale는 어떻게 설치하나요?
- README의 공식 설치 스크립트로 설치하기 npm으로 설치하기: npm install -g codewhale git 저장소의 루트에서 codewhale 실행하기: codewhale /provider를 실행해 provider를 선택하고 API 키를 붙여넣은 다음 작업 입력하기
- Codewhale은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/codewhale-hq/Codewhale
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
지속형 Python 작업 공간과 하위 에이전트, 여러 모델 제공자를 지원하는 Rust 기반 오픈소스 재귀 코딩 에이전트입니다.
터미널에서 로컬로 실행해 코드 작성과 작업을 돕는 OpenAI의 경량 코딩 에이전트입니다.
토큰 사용량과 메모리·리소스 비용을 줄여 여러 AI 에이전트를 실행하는 오픈소스 데스크톱 앱이자 Rust 라이브러리입니다.