Codewhale/docs/i18n/README.vi.md

Tác nhân lập trình mã nguồn mở chạy trong terminal, hoạt động với mọi mô hình.

Giao cho Codewhale một tác vụ, nó sẽ đọc kho mã, chỉnh sửa tệp và chạy lệnh cho đến khi tác vụ hoàn thành hoặc cần bạn cung cấp thêm thông tin. Codewhale hoạt động với hơn 40 nhà cung cấp tích hợp sẵn, mặc định là DeepSeek V4.1 Flash, và với các mô hình chạy trên chính máy của bạn. /receipts liệt kê các tệp nó đã thay đổi, các lệnh nó đã chạy, cùng các lệnh gọi web và MCP nó đã thực hiện.

Trang web · Tài liệu · Nhật ký thay đổi · Đóng góp

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

_{Một bản dựng phát triển 0.10.2 với mô hình thử nghiệm chạy theo kịch bản, ở chế độ Full Access trong một không gian làm việc dùng một lần. Thao tác chỉnh sửa, ba bài kiểm thử và lượt đánh giá của tác nhân phụ đều chạy thật.}

Xem ưu đãi Codewhale × OrcaRouter. Codewhale nhận phí giới thiệu từ OrcaRouter.

Cài đặt

macOS và Linux:

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

Trình cài đặt đặt codewhale và bí danh ngắn codew của nó, đã được xác minh checksum, vào ~/.local/bin. Nếu sau đó shell báo command not found, hãy chạy dòng PATH mà trình cài đặt in ra (chi tiết). Dùng codewhale update để nâng cấp. Các lệnh này cài bản phát hành mới nhất. Trang này theo nhánh main, nên một tính năng được đánh dấu phiên bản sẽ có mặt trong bản phát hành đó; nhật ký thay đổi liệt kê những gì mỗi bản phát hành bổ sung.

Windows, npm, Cargo và các cách cài khác

winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # crates.io; can trail GitHub Releases

Có sẵn tệp nhị phân dựng sẵn cho Linux, macOS và Windows trên x64 và arm64. Nix, Homebrew trên Linux, Android/Termux (bản xem trước) và tải thủ công được trình bày trong hướng dẫn cài đặt, còn container thì ở Docker. Mỗi máy chỉ nên dùng một cách cài đặt; nếu không, hai bản sẽ cùng nằm trên PATH và bản nào đứng trước sẽ được dùng.

Bắt đầu nhanh

1. Commit hoặc stash công việc của bạn, rồi chạy codewhale từ thư mục gốc của một kho git. Theo mặc định, nó áp dụng các chỉnh sửa tệp ở đó mà không hỏi và hiển thị diff cho bạn.
2. Chạy /provider (hoặc nhấn F3), chọn một nhà cung cấp, dán khóa API của nhà cung cấp đó và chọn một mô hình. DeepSeek là nhà cung cấp mặc định. Nếu không có khóa, hãy chọn một runtime cục bộ. Nếu chưa cấu hình nhà cung cấp nào và Ollama đang phục vụ sẵn một mô hình trò chuyện, Codewhale sẽ tự động dùng mô hình đó; từ 0.10.2, nó sẽ đề xuất mô hình đó khi bạn gửi tin nhắn đầu tiên.
3. Nhập một tác vụ:

Fix the failing tests and explain what changed.

Các lệnh chỉ đọc chạy ngay. Với mọi lệnh shell khác, Codewhale hỏi trước: y chạy lệnh một lần, a cho phép các lệnh tương tự trong phần còn lại của cuộc trò chuyện, n từ chối. /undo hoàn tác yêu cầu gần nhất của bạn cùng các thay đổi tệp của nó. /help liệt kê các lệnh và phím tắt.

Với script và CI, codewhale exec chạy một tác vụ mà không cần giao diện. Theo mặc định, --auto dùng Full Access: công cụ chạy mà không hỏi, lệnh shell không bị sandbox của Codewhale giới hạn, và chế độ tin cậy cho phép công cụ tệp ghi ra ngoài không gian làm việc. Thêm --sandbox workspace-write để giữ sandbox cho shell và giới hạn công cụ tệp trong không gian làm việc, đồng thời tắt chế độ tin cậy:

codewhale exec --auto --sandbox workspace-write "fix the failing tests and explain what changed"

Chế độ và quyền

Bản cài đặt mới khởi động ở chế độ Work với quyền Ask.

	Chuyển bằng	Tùy chọn
Chế độ	Tab (khi ô nhập trống) hoặc /mode	Plan đọc và tìm kiếm nhưng không thay đổi gì. Work chỉnh sửa tệp và chạy lệnh. Operate có cùng quyền truy cập như Work, coi yêu cầu của bạn là một mục tiêu và tiếp tục làm cho đến khi mục tiêu được xác minh hoặc cần bạn cung cấp thêm thông tin.
Quyền	Shift+Tab	Ask áp dụng các chỉnh sửa tệp trong kho mã của bạn mà không hỏi, và hỏi trước khi chạy các lệnh shell không phải chỉ đọc. Auto-Review để các quy tắc và một mô hình đánh giá phê duyệt các lệnh gọi thông thường, và từ chối các lệnh gọi rủi ro cao; hãy chuyển sang Ask để tự phê duyệt những lệnh gọi đó. Full Access không bao giờ hỏi và tắt sandbox của Codewhale; các quy tắc của kho mã và chính sách được quản lý vẫn được áp dụng.

Xem chi tiết trong hướng dẫn về chế độ và quyền.

Codewhale làm được gì

Có gì mới trong 0.10.2

• /pet on biến terminal của bạn thành một chú cá voi chuyển động cho thấy tác nhân đang làm gì, trong khi ô nhập tin nhắn vẫn dùng được. 980 hạt của nó ghép thành bước hiện tại bằng tiếng Anh, tiếng Trung hoặc tiếng Nhật.
• /workbar terminal hiển thị các shell mà tác nhân đang chạy ngay trong lúc chúng chạy. Bạn có thể gõ vào một shell, hoặc nhấn Ctrl+N để mở shell của riêng bạn (macOS và Linux).
• /undo hoàn tác toàn bộ yêu cầu gần nhất của bạn trong một bước, gồm mọi tệp mà yêu cầu đó đã thay đổi, và /diff hoạt động cả trong thư mục không dùng Git.
• Khi một kế hoạch đã sẵn sàng, Codewhale hỏi bạn muốn bắt đầu Work với Ask hay Auto-Review, hay tiếp tục lập kế hoạch.
• /color đặt cho mỗi cuộc trò chuyện một màu ô soạn thảo riêng, được lưu cùng phiên.
• web_search có thể dùng Search API mới của DeepSeek: đặt [search] provider = "deepseek" cùng với một khóa DeepSeek.
• Ngoài Full Access, một lệnh curl hoặc wget có thể tải lên thông tin xác thực sẽ không bao giờ chạy khi chưa có sự phê duyệt của bạn, và một lệnh che giấu ký tự Unicode vô hình sẽ bị từ chối. write không còn thay thế một tệp mà tác nhân chưa đọc, hoặc một tệp đã thay đổi sau khi tác nhân đọc nó.

Mô hình

Hơn 40 nhà cung cấp được tích hợp sẵn, gồm Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter và xAI. Mọi endpoint tương thích OpenAI đều dùng được, mô hình cục bộ qua Ollama, vLLM hoặc SGLang cũng vậy. Mặc định là deepseek-flash của DeepSeek, mô hình mà DeepSeek đã chuyển sang DeepSeek-V4.1-Flash-1017 vào ngày 2026-10-17; 0.10.1 chạy được mô hình này mà không cần cập nhật (chi tiết).

/model đổi mô hình giữa các lượt, còn /model auto chọn một mô hình cho từng lượt (/router thiết lập cách chọn). /turn inspect cho biết một lượt đã dùng mô hình nào, tốn bao nhiêu chi phí và mất bao lâu. codewhale auth chatgpt cho phép bạn dùng gói ChatGPT thay cho khóa API (thử nghiệm). Xem Nhà cung cấp.

Biên nhận và hoàn tác

/receipts, hoặc codewhale receipts --last sau khi bạn thoát, liệt kê các tệp đã thay đổi, các lệnh đã chạy, các lệnh gọi web và MCP, các tác nhân đã khởi chạy, các phê duyệt và người đã phê duyệt, cùng các lần thất bại. /undo hoàn tác yêu cầu gần nhất của bạn và những tệp mà yêu cầu đó đã thay đổi trong một bước, không cần chế độ tin cậy. /restore đưa toàn bộ không gian làm việc về một snapshot trước đó; vì thao tác này ghi đè các chỉnh sửa sau đó, nó cần /trust on hoặc Full Access. Xem Biên nhận.

Các lần chạy exec có sẵn công cụ đều được lưu ở mọi định dạng đầu ra, vì vậy codewhale receipts --last dùng được sau exec --auto, kể cả khi dùng --json. Các lần chạy chỉ trả lời bằng văn bản hoặc --json chỉ được lưu khi tiếp tục cuộc trò chuyện hoặc khi bắt đầu nén cuộc trò chuyện; dùng --output-format stream-json để luôn lưu chúng cho biên nhận hoặc exec --continue.

Công việc dài hơi

/goal đặt một mục tiêu được giữ qua các lượt. Codewhale có thể chia việc cho các tác nhân phụ, chạy một nhóm tác nhân, hoặc làm theo một workflow đã được commit vào kho mã.

Chuyển từ tác nhân khác

Codewhale tự đọc AGENTS.md. Các tệp chỉ dẫn viết cho công cụ khác, như CLAUDE.md, .cursorrules hoặc .github/copilot-instructions.md, chỉ được nạp khi bạn chủ động bật bằng project_instruction_imports = ["claude"] (hoặc "cursor", "cline", "windsurf", "copilot", "all") trong cấu hình; xem config.example.toml. Codewhale sẽ cảnh báo khi tìm thấy một tệp như vậy mà nó không nạp.

/import-claude chuẩn bị việc nhập cài đặt Claude Code và các máy chủ MCP của bạn để bạn xem lại. /plugin install chấp nhận các plugin Claude Code chứa skill, lệnh, hồ sơ tác nhân và máy chủ MCP, và từ chối các plugin cần hook hoặc máy chủ LSP (chi tiết).

Tiện ích mở rộng

Kết nối máy chủ MCP, thêm skill và plugin, và chạy hook theo sự kiện phiên và công cụ. Chế độ code (thử nghiệm, bật theo mặc định) cho phép mô hình viết một chương trình execute_tools gọi nhiều công cụ MCP và plugin; mỗi lệnh gọi vẫn tuân theo quy tắc phê duyệt của bạn và vẫn có biên nhận riêng. Plugin Computer Use được cài đặt riêng (thử nghiệm, chỉ có trên macOS) có thể quan sát và điều khiển các ứng dụng khác. Plugin này luôn tắt cho đến khi bạn xem lại quyền truy cập của nó và bật nó lên (hướng dẫn).

Các cách chạy

Lệnh	Chức năng
codewhale	Ứng dụng terminal tương tác
codewhale exec "…"	Một tác vụ không có giao diện. Khi không kèm cờ, nó trả lời mà không dùng công cụ; --auto bật công cụ với Full Access theo mặc định, --sandbox workspace-write giới hạn chúng, còn --output-format stream-json phát trực tiếp các sự kiện dưới dạng JSON
codewhale web	Giao diện web cục bộ tại 127.0.0.1 (hướng dẫn)
codewhale review --pr N	Đánh giá mang tính tham khảo cho một pull request trên GitHub. Thiết lập bot GitHub tạo một workflow được ghim phiên bản cho các đánh giá tự động và @codewhale review, dùng khóa mô hình của riêng bạn và danh tính App tùy chọn
codewhale app-server --http	Runtime API, một API HTTP cục bộ cho thread, sự kiện, phê duyệt và các thay đổi tệp của từng lượt
codewhale serve --acp	Agent Client Protocol qua stdio, dành cho các trình soạn thảo như Zed

Ứng dụng terminal, exec, web và Runtime API dùng chung một engine (kiến trúc). Một tiện ích mở rộng VS Code do cộng đồng duy trì kết nối với engine này từ thanh bên (mã nguồn). Một ứng dụng desktop native xây dựng trên Runtime API đang được phát triển; hiện chưa có bản tải xuống công khai.

Chi phí và tài khoản

Codewhale miễn phí và được cấp phép theo MIT. Khi dùng khóa API của riêng mình, bạn trả tiền trực tiếp cho nhà cung cấp; mô hình cục bộ không cần khóa. Thanh dưới cùng và /cost hiển thị chi phí của một phiên khi biết giá, còn giá chưa biết được hiển thị là chưa biết, không bao giờ là miễn phí.

Bạn không cần tài khoản. Các khóa bạn thêm bằng /provider được lưu trên máy của bạn.

An toàn và quyền riêng tư

Ở Ask và Auto-Review, lệnh chạy trong sandbox của hệ điều hành nếu hệ thống có: Seatbelt trên macOS, và bubblewrap trên Linux khi đã được cài đặt. Windows hiện chưa có sandbox của hệ điều hành, và Full Access tắt sandbox. Bên trong sandbox, lệnh shell không thể đọc các kho thông tin xác thực như ~/.ssh, ~/.aws và các tệp .env; từ 0.10.2, quy tắc này cũng áp dụng cho các phiên terminal và nhiều công cụ tệp hơn. /preview-request hiển thị bản xem trước của yêu cầu tiếp theo, đã che thông tin nhạy cảm, mà không gửi yêu cầu đó đi.

Telemetry được bật theo mặc định. Nó gửi các số liệu tổng hợp (phiên bản và nền tảng, thời lượng và kết quả của phiên, các nhà cung cấp tích hợp sẵn mà bạn đã dùng, số đếm tính năng và lỗi) kèm một ID cài đặt ngẫu nhiên được thay mới sau mỗi 90 ngày, và không bao giờ gửi cuộc trò chuyện, mã nguồn, prompt, tên mô hình, tên tệp hay tên kho mã, hoặc thông tin xác thực. codewhale config set telemetry false sẽ tắt telemetry. Khi khởi động, Codewhale cũng kiểm tra GitHub xem có bản phát hành mới không; đặt CODEWHALE_NO_UPDATE_CHECK=1 để bỏ qua bước này. Xem thêm tại thứ tự cấp quyền, sandbox và telemetry.

Tài liệu

Bắt đầu tại đây	Tham khảo
Cài đặt	Cấu hình
Nhà cung cấp và mô hình cục bộ	Kiến trúc
Chế độ và quyền	Runtime API
Phím tắt	Viết plugin
Đánh giá PR trên GitHub	Toàn bộ tài liệu

Cộng đồng

Nếu thiếu một nhà cung cấp hoặc một quy trình làm việc còn bất tiện, hãy mở một issue hoặc gửi pull request. Người đóng góp được ghi nhận cho phần việc được tích hợp, và cấu trúc kho mã cho biết mọi thứ nằm ở đâu.

Trò chuyện trên Discord, hoặc thêm người duy trì dự án, Hunter, trên WeChat (hunterbown) và xin vào nhóm Whale Brothers.

Lịch sử và giấy phép

Codewhale khởi đầu là deepseek-tui và vẫn đọc cấu hình cùng các phiên của dự án đó. Dự án được duy trì độc lập và không liên kết với DeepSeek hay bất kỳ nhà cung cấp mô hình nào khác. Cảm ơn mọi người đã đóng góp.

MIT. Mã được điều chỉnh từ các dự án mã nguồn mở khác được liệt kê trong thông báo bên thứ ba.