Tác nhân lập trình mã nguồn mở cho mọi mô hình
Codewhale đọc dự án, chỉnh sửa tệp và chạy kiểm thử từ terminal của bạn. Kết nối mô hình được lưu trữ trực tuyến hoặc mô hình cục bộ và chọn những hành động cần bạn phê duyệt.
curl -fsSL https://codewhale.net/install.sh | sh
Codewhale × OrcaRouterGet 30% extra DeepSeek V4.1 Flash credit on each OrcaRouter top-up. One claim per developer, open until November 21, 2026.Codewhale earns a referral fee from OrcaRouter.Claim on OrcaRouter▎ Local demo: add --json to export.py, run tests, and delegate a review. │╭ ✓ • tool done · 3/3 · 100% ││ ▏ checklist: todo_write ││ ▏ ☑ Inspect the export command ││ ▏ ☑ Add the --json flag │╰ ▏ ☑ Run tests and review the change │ │● JSON export is ready. │▏ │▏ Added --json while preserving CSV output. All 3 local tests passed, and the delegated review │▏ found no issues. ┃▏ ┃▏ Try: python3 export.py --json ┃▏ ┃▏ This session uses the local website-demo provider. ┃ ┃Note Workbar is off — no panel renders (/workbar bottom|top|left|right to show it) ┃╭──────────────────────────────────────────────────────────────────────────────────────────────────╮│❯ Type a message… ││ [·] │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ● Full Access Shift+Tab to change work (Tab) Work bar (Ctrl+]) ← for agents · ↓ to manage website-demo · website-demo context 7%
New in v0.10.2
Read the changelog- /pet on
- Turns your terminal into an animated whale that shows what the agent is doing. The message box stays live.
- /workbar terminal
- Shows the shells the agent is running as they run. Type into one, or press Ctrl+N for your own. macOS and Linux.
- /undo
- Takes back your whole last request in one step, including every file it changed.
- Plan → Work
- When a plan ends with open steps, Codewhale asks whether to start Work with Ask or Auto-Review, or keep planning.
- curl / wget
- Outside Full Access, a curl or wget that would upload a credential never runs without your approval.
- DeepSeek Search
- web_search can use DeepSeek's new Search API: set [search] provider = "deepseek" with a DeepSeek key.
Xây dựng và tự động hóa từ terminal
Mô tả những gì bạn muốn xây dựng hoặc tự động hóa. Codewhale có thể chỉnh sửa tệp, chạy lệnh và kiểm tra kết quả, với quyền truy cập do bạn kiểm soát.
Khả năng- Tạo ứng dụng và công cụ
- Tạo ứng dụng, thêm tính năng hoặc viết tập lệnh. Codewhale có thể làm việc với các tệp dự án, chạy mã và kiểm thử những gì nó tạo ra. Tài liệu
- Tự động hóa việc lặp lại
- Chạy quy trình từ terminal, tập lệnh hoặc CI. Với những tác vụ lớn hơn, giao từng phần công việc cho một Fleet tác nhân sử dụng các mô hình khác nhau. Tài liệu
- Kết nối công cụ bạn dùng
- Thêm công cụ qua plugin và máy chủ MCP, hoặc sử dụng API từ các tập lệnh của riêng bạn. Mỗi dịch vụ cần được thiết lập và xác thực riêng. Tài liệu
Sử dụng mô hình bạn chọn
Kết nối tài khoản nhà cung cấp, endpoint tương thích với OpenAI, hoặc mô hình cục bộ và mô hình trên hạ tầng tự quản. Chọn mô hình cho phiên làm việc và cho từng tác nhân trong Fleet.
Xem mô hình và nhà cung cấp- Tài khoản API của bạn
- Kết nối các nhà cung cấp như DeepSeek, OpenAI, Anthropic hoặc Google bằng khóa riêng. Mô hình mặc định deepseek-flash hiện chạy DeepSeek-V4.1-Flash.
- Gateway của bạn
- Dùng endpoint tương thích OpenAI và chọn mô hình nó cung cấp.
- Suy luận của bạn
- Chạy mô hình cục bộ hoặc tự lưu trữ bằng Ollama, vLLM hoặc SGLang.
- Gói ChatGPT của bạn
- Đăng nhập bằng codewhale auth chatgpt để dùng gói ChatGPT thay cho khóa API. Tính năng thử nghiệm.
Làm việc với tệp và công cụ
Khám phá công cụ và tích hợp- Tệp và terminal
- Tạo tệp, chạy lệnh, xem dữ liệu và kiểm thử sản phẩm. Bạn đặt thư mục làm việc và quyền truy cập.
- Plugin và ứng dụng đã kết nối
- Thêm kỹ năng và công cụ qua plugin và MCP. Xem xét và bật các kết nối bạn muốn tác tử sử dụng.
- Trình duyệt và máy tính · xem trước
- Dùng công cụ trình duyệt và plugin Computer Use để làm việc trong ứng dụng và website với quyền bạn cấp.
- Phiên có thể tiếp tục
- Giữ cuộc trò chuyện, kết quả công cụ và lịch sử công việc cùng nhau. Tiếp tục tác vụ trong terminal hoặc client trình duyệt cục bộ.
- Đội tác tử
- Dùng Fleet chia công việc lớn cho tác tử có vai trò và mô hình khác nhau, rồi theo dõi tiến độ ở một nơi.
Bắt đầu sử dụng
Cài đặt Codewhale, kết nối một mô hình và mở thư mục dự án. Bạn có thể thêm plugin và tác nhân khi cần.
Install Codewhale
Install the latest release on macOS or Linux. Follow any PATH instruction the installer prints, then open a folder where you want to work. The guide covers Windows and other install options.
Full install guidecurl -fsSL https://codewhale.net/install.sh | shConnect your model
Use a model API you already have, or connect local or self-hosted inference. The command below saves a DeepSeek key; local Ollama models do not need an API key.
Connect a providercodewhale auth set --provider deepseekDescribe your first task
Start Codewhale and describe the result: a small app, a script that saves you time, or a report from your data. Choose its permissions, review what it does and steer it as you go.
Set modes and approvalscodewhaleUse multiple agents
Split a larger job across agents with different roles and models. Inside Codewhale, save your team with /fleet setup, then check its runs with /fleet status.
Set up a Fleet/fleet setup /fleet status
Đã có và đang phát triển
Terminal và client trình duyệt cục bộ đã có sẵn. Ứng dụng desktop gốc và ứng dụng web lưu trữ trực tuyến đang được phát triển.
- Terminal và trình duyệt cục bộ
- Đã phát hànhCài đặt trên Linux, macOS hoặc Windows, rồi chạy codewhale, hoặc codewhale web để dùng client trình duyệt cục bộ. Bạn cũng có thể dùng npm và Cargo; bản Android trên Termux là bản xem trước.
- CodeWhale GUI (VS Code)
- Có sẵnMột dự án riêng do cộng đồng duy trì: trò chuyện, chủ đề và thay đổi tệp trong thanh bên VS Code trên cùng Codewhale Runtime. Cài đặt từ VS Code Marketplace.
- Ứng dụng web lưu trữ trực tuyến
- Đang phát triểnĐang được xây dựng lại cho khớp với ứng dụng desktop và chưa mở. Để dùng trong trình duyệt ngay hôm nay, hãy chạy codewhale web trên máy của bạn.
- Máy tính để bàn
- Bản phát triểnỨng dụng gốc dùng cùng bộ máy. Xem xét và commit thay đổi, theo dõi công việc giữa các dự án, và chỉnh sửa một tin nhắn để gửi lại thành một nhánh mới. Hiện chưa có bản tải xuống công khai.
Terminal, trình duyệt cục bộ và GUI không cần tài khoản Codewhale. Khi bạn dùng khóa riêng của mình từ nhà cung cấp, nhà cung cấp đó tính phí phần sử dụng này.
Đóng góp cho Codewhale
393 người đã góp phần xây dựng Codewhale. Báo lỗi, cải thiện tài liệu hoặc đóng góp mã trên GitHub.
Cài đặt trên macOS hoặc Linux
GitHub Releases (Bản nhị phân) · npm · Cargo · Docker · Windows · Android / Termux · Mirror Trung Quốc
Đọc hướng dẫn cài đặtcurl -fsSL https://codewhale.net/install.sh | sh