Xây dựng với CometAPICần một API cho nhiều mô hình?Kiểm thử quy trình trong Playground, sau đó tạo API key khi mô hình và chi phí phù hợp với trường hợp sử dụng của bạn.
Cách sử dụng Claude Code trên máy tính để bàn— một hướng dẫn chuyên nghiệp
Trong tháng này, Anthropic đã phát hành bản xem trước trên máy tính để bàn của Claude Code — một ứng dụng gốc trên máy tính để bàn đưa các quy trình lập trình mang tính tác tử của Anthropic ra khỏi dòng lệnh và vào môi trường đồ họa, với hỗ trợ tích hợp để chạy song song nhiều phiên lập trình được cách ly. Bản xem trước trên máy tính để bàn được thiết kế để hoạt động song song với các phiên bản web và di động của Claude Code và tập trung vào hai vấn đề thực tiễn của nhà phát triển: chạy nhiều tác tử AI trên cùng một kho mã mà không xung đột lẫn nhau, và giúp việc bắt đầu các phiên cục bộ hoặc trên đám mây từ một GUI duy nhất trở nên dễ dàng hơn.
Tháng này, Anthropic đã phát hành bản xem trước cho Claude Code trên máy tính để bàn — một ứng dụng máy tính để bàn gốc đưa các quy trình mã hóa kiểu tác nhân của Anthropic ra khỏi terminal và vào môi trường đồ họa, với hỗ trợ tích hợp để chạy song song nhiều phiên mã hóa cách ly. Bản xem trước trên desktop được thiết kế để hoạt động song song với phiên bản web và di động của Claude Code và tập trung vào hai vấn đề thực tiễn của nhà phát triển: chạy nhiều tác nhân AI trên cùng một kho mà không dẫm chân nhau, và giúp bạn dễ dàng bắt đầu phiên cục bộ hoặc đám mây từ một GUI.
Claude Code trên Desktop là gì?
Claude Code trên Desktop là ứng dụng (bản xem trước) gốc trên máy tính để bàn cho phép nhà phát triển chạy các phiên Claude Code trên máy cục bộ hoặc trên hạ tầng đám mây bảo mật của Anthropic bằng GUI thay vì chỉ dùng CLI. Ứng dụng kết hợp các năng lực mã hóa dạng tác nhân cốt lõi của Claude Code với sự tiện lợi trên desktop: quản lý phiên, tích hợp môi trường cục bộ và khởi chạy phiên web bằng một cú nhấp. Ứng dụng được định vị rõ ràng như một “bạn đồng hành” cho CLI và web của Claude Code; nó đóng gói một runtime Claude Code ổn định và quản lý phiên bản giúp bạn duy trì trải nghiệm nhất quán và ổn định.
Đã được xem xét về độ rõ ràng, ghi nguồn và thuật ngữ API hiện tại.
Tại sao điều này quan trọng? Trước đây, công cụ mã hóa AI hoặc chạy hoàn toàn trong terminal (dành cho nhà phát triển quen với quy trình CLI) hoặc hoàn toàn trên đám mây (UI trình duyệt). Ứng dụng desktop thu hẹp khoảng cách đó bằng cách cho phép chạy cục bộ độ trễ thấp và cho phép bạn chuyển đổi mượt mà sang các phiên (web) do Anthropic lưu trữ khi cần tài nguyên tính toán đám mây cách ly hoặc kiểm soát cấp doanh nghiệp. Bản xem trước trên desktop đặc biệt đáng chú ý khi hỗ trợ chạy song song nhiều phiên — bạn có thể chạy đồng thời nhiều tác nhân Claude Code độc lập trên cùng một kho, mỗi tác nhân trong worktree Git riêng (không gian làm việc nhánh cách ly) để các tác nhân không xung đột với nhau. Đây là tính năng nổi bật mà nhiều nhóm sẽ thấy hữu ích ngay lập tức.
Phiên bản desktop liên hệ thế nào với các phiên bản web và CLI?
Claude Code bắt đầu là một công cụ dòng lệnh và sau đó mở rộng sang giao diện web và di động; bản xem trước trên desktop xây dựng trên những nền tảng đó. Ứng dụng desktop phản chiếu nhiều khả năng có trên web (khởi chạy phiên, kết nối kho, xem tiến trình) nhưng tập trung vào tiện ích quy trình cục bộ — UX trên desktop, cài đặt gốc và tích hợp chặt chẽ hơn với kho Git cục bộ thông qua worktree — để các phiên có thể chạy đồng thời mà không can thiệp trạng thái tệp của nhau.
Claude Code cho Desktop hỗ trợ chạy đồng thời nhiều phiên Claude độc lập. Điều đó có nghĩa bạn có thể có một phiên tập trung sửa lỗi, một phiên viết kiểm thử và một phiên tạo tài liệu — tất cả cùng thực thi thay vì xếp hàng trong một phiên duy nhất. Tính song song này tăng tốc quy trình và cho phép bạn ủy thác các tác vụ khác nhau cùng lúc.
Ví dụ:
Giả sử bạn có một dự án tên là my-app, và bạn muốn:
Để Claude thay đổi trang chủ trong một cửa sổ;
Để Claude tối ưu logic cơ sở dữ liệu trong cửa sổ khác.
Hai bản sao độc lập (không xung đột). Điều này giống như chạy đồng thời hai nhánh phát triển, với Claude xử lý từng nhánh cho bạn.
2. .worktreeinclude: Khiến Claude nhận biết các tệp bị bỏ qua
Đôi khi dự án của bạn có các tệp như .env hoặc .local, thường bị .gitignore bỏ qua và sẽ không được sao chép vào thư mục làm việc của Claude. Các tệp được liệt kê trong .gitignore sẽ không được tự động sao chép vào các worktree mới. Claude cung cấp một cơ chế mới: Bạn có thể tạo tệp .worktreeinclude ở thư mục gốc của dự án, cho biết tệp nào cần được sao chép — một danh sách theo phong cách .gitignore chỉ định các tệp bị bỏ qua nào sẽ được sao chép vào các worktree mới tạo (ví dụ, các tệp .env cục bộ hoặc thiết lập dành riêng cho nhà phát triển). Chỉ những tệp xuất hiện trong cả .worktreeinclude và .gitignore mới được sao chép, giúp tránh vô tình nhân bản các tệp đã được theo dõi. Điều này rất quan trọng để bảo toàn các tệp bí mật hoặc môi trường theo từng phiên mà không cần đưa chúng vào Git.
Điều này có nghĩa là: Khi Claude tạo thư mục làm việc, các tệp này cũng sẽ được sao chép.
Lưu ý:
Chỉ những tệp tồn tại đồng thời trong .gitignore và .worktreeinclude mới được sao chép;
Tránh vô tình sao chép các tệp đã theo dõi quan trọng.
3) Khởi chạy và đồng bộ với các phiên web/đám mây
Ứng dụng desktop có thể đóng vai trò trình khởi chạy cho các phiên web/đám mây — nghĩa là bạn có thể khởi chạy các phiên Claude Code trên đám mây từ UI desktop và theo dõi hoặc điều khiển chúng cục bộ. Chế độ lai này hữu ích nếu bạn muốn sự tiện lợi của điều khiển cục bộ với khả năng mở rộng hoặc mô hình quyền của các lượt chạy được lưu trữ trên đám mây.
Lưu ý:
Khi chạy trên đám mây, các tác vụ của Claude sẽ được thực thi trên máy chủ bảo mật của Anthropic.
Việc chuyển đổi giữa môi trường cục bộ và đám mây là liền mạch.
Để tạo một phiên, chỉ cần chọn "remote environment".
4) Khởi chạy và đồng bộ với các phiên web/đám mây
Ứng dụng desktop có thể đóng vai trò trình khởi chạy cho các phiên web/đám mây — nghĩa là bạn có thể khởi chạy các phiên Claude Code trên đám mây từ UI desktop và theo dõi hoặc điều khiển chúng cục bộ. Chế độ lai này hữu ích nếu bạn muốn sự tiện lợi của điều khiển cục bộ với khả năng mở rộng hoặc mô hình quyền của các lượt chạy được lưu trữ trên đám mây (cục bộ cho tác vụ nhanh, đám mây cho tác vụ rủi ro hoặc nặng tài nguyên).
5) Phiên bản đóng gói và cấu hình doanh nghiệp
Desktop bao gồm một runtime Claude Code ổn định được tải xuống ở lần khởi chạy đầu tiên và được quản lý tự động. Quản trị viên doanh nghiệp có thể vô hiệu hóa việc sử dụng Claude Code cục bộ nếu cần (chính sách doanh nghiệp isClaudeCodeForDesktopEnabled). Trình cài đặt desktop hỗ trợ các định dạng triển khai doanh nghiệp phổ biến (MSIX cho Windows, PKG cho macOS), và quản trị viên có thể kiểm soát cập nhật và quyền truy cập tiện ích mở rộng. Các kiểm soát này giúp việc áp dụng dễ dàng hơn cho các nhóm lớn.
Lưu ý:
Ứng dụng sẽ tự động tải xuống khi lần đầu mở;
Ứng dụng desktop tự động quản lý cập nhật phiên bản;
Ứng dụng tự động dọn dẹp các phiên bản cũ để giữ hệ thống sạch;
Dù bạn đã cài bản CLI trên máy, ứng dụng vẫn sẽ dùng phiên bản riêng của nó (để ổn định hơn).
Bản desktop ưu tiên ổn định và tương thích; CLI (phiên bản dòng lệnh) có thể cập nhật nhanh hơn, nhưng tính năng mới có thể chưa đồng bộ ngay sang bản desktop.
6) Biến môi trường tùy chỉnh
Claude Desktop cho phép bạn đặt biến giống như các tệp .env.
Các biến này chỉ có hiệu lực trong phiên Claude, lý tưởng cho cấu hình dự án.
Khi chạy các phiên cục bộ, ứng dụng desktop trích xuất $PATH của shell để các tiến trình trong phiên có thể dùng cùng node, npm, yarn, Python hoặc công cụ CLI khác mà bạn đang dựa vào. Ứng dụng cũng cung cấp UI để thêm biến môi trường tùy chỉnh (theo định dạng .env), với giá trị được che để bảo mật. Điều này giúp chạy kiểm thử hoặc build trong một phiên dạng tác nhân mượt mà hơn vì tác nhân có thể gọi cùng chuỗi công cụ như trong terminal của bạn.
Cách cài đặt Claude Code trên Desktop?
Phần này hướng dẫn quy trình cài đặt với ít ma sát nhất. Các hướng dẫn bên dưới áp dụng cho bản xem trước trên desktop và trỏ bạn đến các trình cài đặt chuẩn.
Điều kiện tiên quyết và thiết lập tài khoản
Tài khoản và workspace Anthropic: Claude Code tích hợp với Anthropic Console. Bạn sẽ cần hoàn tất luồng OAuth trong Claude Console và có quyền thanh toán hoạt động hoặc quyền truy cập bản xem trước nghiên cứu theo yêu cầu của mô hình workspace của Anthropic. Claude Code sử dụng một workspace nội bộ trong console để theo dõi mức sử dụng; bạn không thể tạo khóa API cho workspace đó — workspace được quản lý cho mục đích sử dụng Claude Code.
Git và mức sẵn sàng của repo: Đảm bảo Git đã được cài đặt và dự án bạn muốn thao tác là một kho Git (hoặc khởi tạo Git). Ứng dụng desktop kỳ vọng các repo hợp lệ cho các tính năng như worktree; nếu bạn mở một thư mục chưa khởi tạo Git, worktree sẽ không được tạo.
Đặc thù hệ điều hành: Cài đặt trên macOS và Linux thường là binary gốc; người dùng Windows được khuyến nghị dùng WSL để có độ tương thích lệnh đầy đủ trong nhiều quy trình. Một số hướng dẫn cộng đồng đề cập thiết lập Windows/WSL nâng cao nếu bạn gặp vấn đề về PATH hoặc distribution.
Cài đặt từng bước (ngắn)
Mở trang Tải xuống Claude và chọn trình cài đặt đúng cho nền tảng của bạn.
Chạy trình cài đặt (PKG trên macOS, MSIX hoặc EXE trên Windows). Với đội ngũ doanh nghiệp, dùng các gói MSIX/PKG để triển khai tập trung.
Khởi chạy ứng dụng Claude Desktop và đăng nhập bằng tài khoản Anthropic/Claude của bạn. Cuộc trò chuyện và tùy chọn của bạn sẽ đồng bộ trên desktop, web và di động.
Ở lần mở đầu, ứng dụng sẽ tải xuống runtime Claude Code đóng gói. Hãy cho phép tải xuống hoàn tất; đây là yêu cầu giúp đảm bảo dùng phiên bản ổn định, được quản lý.
Kiểm tra sau cài đặt
• Mở Settings > Environments và xác nhận ứng dụng desktop đã trích xuất $PATH của shell bạn.
• Chọn bật các phiên cục bộ (nếu máy và chính sách cho phép) hoặc quyết định quy trình của bạn sẽ tạo các phiên web.
Tùy chọn phương thức cài đặt nên chọn
Trình cài đặt gốc (khuyến nghị): Dùng trình cài đặt gốc của hệ điều hành để có trải nghiệm đơn giản và tích hợp nhất.
Homebrew (macOS): Tiện lợi cho người dùng macOS quản lý ứng dụng bằng Homebrew.
NPM hoặc trình cài đặt dựa trên script: Hữu ích cho thiết lập tự động hoặc theo kịch bản (CI hoặc provisioning), hoặc cho các bản phân phối Linux nơi ưu tiên script cài đặt đơn giản.
Cài đặt: macOS, Linux, WSL (luồng khuyến nghị)
Tải trình cài đặt bản xem trước desktop từ trang tải xuống Claude Code (tài liệu trong sản phẩm cung cấp liên kết trình cài).
Chạy trình cài và mở ứng dụng desktop Claude.
Hoàn tất đăng nhập OAuth qua luồng Claude Console trong ứng dụng.
Cấu hình vị trí worktree mặc định và ưu tiên thực thi cục bộ/đám mây trong cài đặt desktop.
Mở một thư mục dự án hoặc clone một repo từ UI để bắt đầu.
Mở terminal và, nếu bạn tin tưởng nguồn, hãy chạy script cài đặt do Anthropic cung cấp (đây là lựa chọn tiện lợi thường được khuyến nghị). Ví dụ (phỏng theo):
Cài WSL (Ubuntu là lựa chọn phổ biến) và thiết lập môi trường WSL sạch. Giải quyết các vấn đề PATH và interop để tích hợp WSL của ứng dụng desktop có thể truy cập distro.
Cài Git và bất kỳ runtime ngôn ngữ nào trong WSL mà Claude có thể cần cho các lượt chạy cục bộ (node, python, v.v.).
Cài hoặc chạy ứng dụng desktop trên Windows, trỏ nó đến thư mục dự án WSL của bạn (hoặc khởi chạy ứng dụng desktop bên trong WSL nếu được hỗ trợ), và làm theo cùng luồng OAuth.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Cách sử dụng Claude Code trên Desktop trong thực tế hằng ngày?
Các mô hình tạo phiên được khuyến nghị là gì?
Nhiệm vụ ngắn độc lập so với tái cấu trúc dài hạn
Với tác vụ ngắn, phạm vi hẹp (sửa lỗi, thay đổi một tệp, tái cấu trúc nhỏ), hãy tạo một phiên cho mỗi tác vụ và để Claude tạo một commit tập trung. Xem xét và hợp nhất ngay.
Với nỗ lực dài hạn (tái cấu trúc lớn, phát triển tính năng), cân nhắc tạo một phiên có checkpoint thường xuyên và dùng điều khiển tiến trình của UI desktop để điều hướng hoặc tạm dừng công việc. Giữ các phiên trên nhánh tính năng để tránh hợp nhất ngoài ý muốn.
Duy trì một CLAUDE.md hoặc một mẫu prompt trong repo để tiêu chuẩn hóa cách nên nhắc lệnh cho các phiên (ngữ cảnh, kiểm thử cần chạy, quy tắc phong cách). Thực hành này giảm biến thiên và giúp Claude tạo ra kết quả nhất quán giữa các phiên. Nhiều nhóm lưu trữ prompt tiêu chuẩn hoặc hàng rào bảo vệ trong metadata của repo để đảm bảo hành vi tác nhân có thể dự đoán.
Khởi chạy và đặt tên một phiên
Mở ứng dụng desktop và chọn hoặc clone một repository.
Nhấp “New Session” (hoặc tương đương) và đặt tên mô tả cho phiên (ví dụ, bugfix/cs-142 hoặc add-tests-login). Việc đặt tên giúp bạn phân biệt các phiên đồng thời trong UI.
Chọn chế độ thực thi cục bộ hoặc từ xa, chọn nhánh mục tiêu (hoặc để tác nhân tạo nhánh trong worktree mới), và bắt đầu phiên. Ứng dụng tự động tạo một worktree Git riêng cho phiên.
Điều khiển tác nhân: nhắc lệnh và nhiệm vụ
Dùng prompt rõ ràng, có phạm vi. Ví dụ: “Tìm unit test đang thất bại cho AuthService và tạo bản sửa chữa giữ nguyên API công khai hiện có; chạy test và báo cáo kết quả.”
Với các tác vụ gia tăng, hãy yêu cầu Claude tạo một kế hoạch trước (danh sách ngắn), sau đó yêu cầu thay đổi mã cụ thể theo từng bước. Tiến độ gia tăng giảm rủi ro ảo tưởng và giúp diff dễ xem xét hơn. Anthropic khuyến nghị cách tiếp cận này trong thực tiễn tốt nhất.
Theo dõi tiến độ và tương tác
UI desktop hiển thị log hành động và diff khi tác nhân làm việc. Bạn có thể tạm dừng phiên, thay đổi chỉ dẫn, hoặc hủy một job đang chạy. Khi tác nhân đề xuất chỉnh sửa, UI sẽ hiển thị diff tệp và giải thích những gì đã thay đổi. Phê duyệt, chỉnh sửa hoặc từ chối diff được đề xuất trước khi commit.
Luồng commit, branch và PR
Khi bạn phê duyệt thay đổi, ứng dụng desktop có thể commit vào nhánh worktree của phiên. Từ đó bạn có thể push lên origin và mở pull request qua UI (nếu bạn đã ủy quyền quyền truy cập GitHub). Mỗi nhánh của phiên vẫn được cách ly cho đến khi bạn merge, giúp quá trình review của con người đơn giản.
Cách cơ chế cách ly của Git và chạy song song nhiều phiên hoạt động thực tế?
Git worktrees: cơ chế cách ly
Desktop của Anthropic sử dụng worktree của Git để tạo các bản sao không gian làm việc theo từng phiên gắn với các nhánh riêng. Worktree nhẹ hơn full clone — chúng chia sẻ metadata .git khi phù hợp nhưng cung cấp các thư mục làm việc độc lập để các chỉnh sửa đồng thời không xung đột hoặc rò rỉ giữa các phiên. Ứng dụng desktop đặt các worktree được tạo tự động này trong một thư mục có thể cấu hình (mặc định ~/.claude-worktrees). Thiết kế này cho phép thực thi đồng thời an toàn cho các hoạt động dạng tác nhân.
Vì sao chọn worktree thay vì clone
Worktree nhanh tạo hơn và dễ liên hệ với cùng lịch sử Git bên dưới, đồng thời vẫn cung cấp tách biệt hệ thống tệp cần thiết để tránh nhiễm chéo giữa các phiên. Với hầu hết quy trình, điều này tốt hơn nhiều clone đầy đủ; tuy nhiên, nếu bạn cần môi trường runtime hoàn toàn cách ly với phụ thuộc khác nhau, một clone riêng hoặc container vẫn có thể là lựa chọn đáng cân nhắc.
Phối hợp và xử lý xung đột
Vì mỗi phiên làm việc trên một nhánh/worktree cách ly, xung đột được giảm thiểu. Nếu hai phiên độc lập thay đổi cùng một phần mã và cả hai được merge vào cùng một nhánh mục tiêu sau đó, xử lý xung đột merge thông thường của Git sẽ áp dụng — đó là thời điểm thích hợp cho việc review và giải quyết của con người. Mô hình của Anthropic chủ đích hiển thị commit dưới dạng PR có thể review, luôn giữ con người trong vòng lặp merge.
Các bước khắc phục sự cố phổ biến và hạn chế
Nếu một phiên không khởi động được hoặc bị treo
Xác nhận token truy cập repository hợp lệ và không bị giới hạn tốc độ.
Kiểm tra dung lượng đĩa cục bộ và quyền cho thư mục worktree (ví dụ, ~/.claude-worktrees).
Xem log của ứng dụng desktop để tìm thông báo lỗi; ứng dụng thường có màn hình chẩn đoán hoặc tệp log.
Nếu các phiên nhiễm chéo lẫn nhau
Xác nhận ứng dụng desktop đang tạo các worktree riêng (kiểm tra thư mục ~/.claude-worktrees hoặc vị trí worktree trong phần tùy chọn ứng dụng).
Nếu bạn thấy trạng thái chia sẻ, hãy đảm bảo đang dùng bản xem trước desktop mới nhất hoặc tham khảo tài liệu của Anthropic — bản phát hành này tập trung giải quyết cách ly phiên.
Nếu các tệp bị bỏ qua không có sẵn cho các phiên
Thêm tên tệp vào cấu hình .worktreeinclude của bạn (hoặc tương đương trong UI desktop) để ứng dụng sao chép các tệp bị bỏ qua cần thiết (ví dụ, .env) vào mỗi worktree một cách an toàn. Tránh lưu trữ bí mật trong, hoặc phơi lộ chúng từ, các worktree nếu không có quản lý bí mật phù hợp.
Kết luận
Bản xem trước desktop của Claude Code đại diện cho một bước tiến có ý nghĩa trong cách các công cụ mã hóa dạng tác nhân phù hợp với quy trình của nhà phát triển: vẫn giữ tốc độ và tính biểu đạt của tác nhân AI đồng thời giải quyết nhiều vấn đề phối hợp thực tế mà nhà phát triển gặp phải khi nhiều tác nhân cần thao tác trên cùng một codebase. Dù bạn áp dụng cho năng suất cá nhân hay để phối hợp nhiều tác vụ tác nhân trong một nhóm, việc hiểu Git worktree, .worktreeinclude, và sự khác biệt giữa phiên cục bộ so với phiên web sẽ giúp tuần đầu tiên của bạn với bản xem trước desktop hiệu quả hơn nhiều.
Sẵn sàng dùng Claude Code CLI? Hãy tham khảo API guide để có hướng dẫn chi tiết.
Nhà phát triển có thể truy cập Claude Opus 4.5 API v.v. thông qua CometAPI, phiên bản model mới nhất luôn được cập nhật theo trang chính thức. Để bắt đầu, hãy khám phá khả năng của model trong Playground và tham khảo API guide để có hướng dẫn chi tiết. Trước khi truy cập, vui lòng đảm bảo bạn đã đăng nhập CometAPI và lấy API key. CometAPI cung cấp mức giá thấp hơn đáng kể so với giá chính thức để giúp bạn tích hợp.
