Hướng dẫn Capri AI: Thiết lập tác nhân máy tính cho Claude Code, Codex và hơn thế nữa

Capri AI là gì?

Capri AI là ứng dụng máy tính để bàn trên Windows, cung cấp một giao diện duy nhất để làm việc với Claude Code, Codex, Antigravity và các trợ lý AI khác. Thay vì chuyển đổi giữa các terminal và công cụ riêng biệt, bạn mô tả mục tiêu bằng ngôn ngữ tự nhiên rồi để trợ lý được kết nối lập kế hoạch và thực hiện công việc thông qua Capri.

Capri có thể làm việc với các tệp và thư mục dự án, sử dụng lệnh shell và ứng dụng, tương tác với web, viết và chạy mã cũng như tạo các hoạt động tự động hóa. Ứng dụng có cơ chế phê duyệt để bạn xem xét các hành động nhạy cảm trước khi chúng được thực hiện.

Tính năng chính

• Nhiều công cụ AI: Chuyển đổi giữa Claude Code, Codex, Antigravity và các bộ chuyển đổi trợ lý tùy chỉnh.
• Quy trình làm việc gốc trên máy tính: Sử dụng ứng dụng đồ họa mà không cần làm việc trực tiếp trong terminal.
• Tệp và dự án: Yêu cầu Capri tìm, đọc, sắp xếp, chỉnh sửa và làm việc trên các thư mục dự án.
• Công cụ tác vụ: Cho phép công cụ được chọn lập kế hoạch, sử dụng công cụ, kiểm tra kết quả và phản hồi.
• Hỗ trợ lập trình: Viết, tái cấu trúc, gỡ lỗi và chạy mã thông qua công cụ bạn đã chọn.
• Tự động hóa: Biến các công việc lặp lại thành một yêu cầu bằng ngôn ngữ tự nhiên.
• Kiểm soát phê duyệt: Xem xét hoặc từ chối các hành động trước khi Capri thực hiện.
• Giọng nói và giao diện máy tính: Trò chuyện với Capri bằng cách nhập văn bản hoặc giọng nói, sử dụng cụm từ đánh thức tùy chọn “Hey Capri” và tùy chỉnh giao diện máy tính cyberpunk của cô ấy.

Yêu cầu hệ thống và tải xuống

Hiện Capri có sẵn cho Windows 10 trở lên. Các phiên bản macOS và Linux đang được lên kế hoạch nhưng chưa có sẵn.

Tải bản phát hành Windows mới nhất từ trang phát hành Capri. README liệt kê gói ZIP portable, có thể chạy từ bất kỳ thư mục nào mà không cần cài đặt. Dự án cũng có tài liệu về gói cài đặt mang tên Capri-Setup.exe.

Cài đặt và khởi chạy lần đầu

1. Chọn bản Windows

Sử dụng bản portable nếu bạn muốn giữ Capri trong một thư mục cụ thể hoặc chạy ứng dụng mà không cần cài đặt. Sử dụng trình cài đặt nếu bạn muốn thiết lập Windows tiêu chuẩn và có mục trong menu Start.

2. Cài đặt hoặc giải nén Capri

1. Đối với trình cài đặt, chạy Capri-Setup.exe và làm theo trình hướng dẫn cài đặt.
2. Đối với phiên bản portable, giải nén Capri-Portable.zip vào thư mục bạn chọn.
3. Khởi chạy Capri. Nếu đã dùng trình cài đặt, bạn có thể mở ứng dụng từ menu Start của Windows.

Windows SmartScreen có thể cảnh báo rằng ứng dụng chưa được tải xuống nhiều. Nếu bạn lấy tệp từ trang Releases chính thức của kho mã, hãy chọn More info, sau đó chọn Run anyway.

3. Kết nối trợ lý AI

Trong lần khởi chạy đầu tiên, Capri sẽ hỏi bạn muốn sử dụng trợ lý nào. Chọn một công cụ có sẵn như Claude Code, Codex hoặc Antigravity. Sau đó đăng nhập vào tài khoản hoặc cung cấp API key cần thiết. Bạn có thể kết nối các trợ lý khác thông qua các bộ chuyển đổi tùy chỉnh.

Yêu cầu Capri hoạt động như thế nào?

Capri sử dụng mô hình tương tác đơn giản:

1. Mô tả mục tiêu: Viết điều bạn muốn bằng ngôn ngữ thông thường hoặc giao tiếp bằng giọng nói.
2. Định tuyến yêu cầu: Capri gửi yêu cầu đến công cụ AI bạn đã chọn.
3. Lập kế hoạch tác vụ: Công cụ xác định các bước và công cụ cần thiết.
4. Xem xét hành động: Capri hiển thị các hành động nhạy cảm để bạn phê duyệt khi chế độ phê duyệt được bật.
5. Thực hiện và báo cáo: Capri thực hiện các thao tác đã được phê duyệt và báo cáo kết quả.

Lớp công cụ có thể làm việc với các tệp và dự án, lệnh shell và ứng dụng cũng như web. Bạn cũng có thể dừng một tác vụ đang chạy bằng cách nhấn Esc.

Ví dụ sử dụng thực tế

Sắp xếp một thư mục

Để dọn dẹp thư mục Downloads, hãy yêu cầu:

Dọn dẹp thư mục Downloads của tôi và nhóm mọi thứ theo loại.

Capri có thể quét thư mục, đề xuất kế hoạch và di chuyển tệp sau khi bạn phê duyệt thao tác. Hãy xem xét kỹ các thay đổi được đề xuất trước khi cho phép di chuyển hoặc đổi tên tệp.

Gỡ lỗi một dự án

Mở hoặc tham chiếu đến một thư mục dự án rồi yêu cầu:

Tìm lỗi trong dự án này và sửa lỗi đó.

Công cụ được kết nối có thể đọc mã, xác định vấn đề có khả năng xảy ra, áp dụng bản vá và chạy các bước kiểm tra. Hãy xác nhận đúng thư mục dự án có thể truy cập được và kiểm tra các thay đổi trước khi chấp nhận.

Tóm tắt tài liệu

Đối với một thư mục chứa các tệp PDF, bạn có thể sử dụng:

Tóm tắt mọi tệp PDF trong thư mục này thành một tài liệu.

Capri có thể đọc các tệp và tạo bản tóm tắt tổng hợp. Đảm bảo thư mục chỉ chứa những tài liệu bạn muốn gửi đến nhà cung cấp AI được kết nối.

Tạo và khởi chạy ứng dụng web

Để bắt đầu một dự án phát triển mới, hãy thử:

Thiết lập một ứng dụng web mới và khởi chạy ứng dụng đó.

Trợ lý có thể tạo cấu trúc dự án, cài đặt các phần phụ thuộc và khởi chạy ứng dụng. Vì yêu cầu này có thể tạo tệp và chạy lệnh, hãy sử dụng chế độ phê duyệt và xem xét từng thao tác được đề xuất.

Tạo tác vụ lặp lại

Bạn có thể mô tả một công việc lặp lại theo cách tự nhiên:

Mỗi thứ Hai, sao lưu thư mục Documents của tôi.

README liệt kê tính năng tự động hóa là một khả năng hiện có. Tuy nhiên, lộ trình cũng liệt kê trình lập lịch tác vụ chuyên dụng là tính năng dự kiến, vì vậy cách triển khai tác vụ lặp lại cụ thể có thể phụ thuộc vào bản phát hành hiện tại.

Cấu hình quyền

Cấu hình mẫu của Capri sử dụng lựa chọn engine, chế độ quyền, các thư mục được phép và giao diện trực quan:

engine: claude-code        # claude-code | codex | antigravity | custom

permissions:
  mode: ask                # hỏi trước khi thực hiện | tự động | chỉ đọc
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

Chế độ ask là điểm khởi đầu an toàn nhất vì Capri yêu cầu xác nhận trước khi thực hiện. Chế độ read-only hữu ích khi bạn muốn phân tích mà không thay đổi dữ liệu. Ví dụ cũng hiển thị auto, cho phép các hành động tự động chạy; chỉ sử dụng chế độ này khi bạn hiểu rõ rủi ro và đã giới hạn các thư mục có thể truy cập.

Mẹo nâng cao cho quy trình làm việc an toàn hơn

• Bắt đầu với quyền hạn hẹp: Chỉ cho phép truy cập Documents, Projects hoặc các thư mục khác cần thiết cho tác vụ hiện tại.
• Duy trì phê duyệt: Đọc các thao tác được đề xuất trước khi xóa, di chuyển, ghi đè hoặc thực thi bất kỳ nội dung nào.
• Sao lưu dữ liệu quan trọng: Tạo bản sao lưu trước khi thực hiện các thao tác tệp lớn hoặc yêu cầu tự động hóa trên phạm vi rộng.
• Bảo vệ thông tin xác thực: Không bao giờ chia sẻ khóa API, token tài khoản hoặc các bí mật khác với người khác.
• Sử dụng yêu cầu rõ ràng: Nêu thư mục đích, đầu ra mong muốn, các hạn chế và liệu Capri có được phép sửa đổi tệp hay không.
• Ngắt khi cần thiết: Nhấn Esc để dừng Capri trong khi một tác vụ đang hoạt động.
• Kiểm tra chính sách của nhà cung cấp: Các yêu cầu được xử lý bởi trợ lý AI mà bạn kết nối, theo các điều khoản và chính sách quyền riêng tư của nhà cung cấp đó.

Tính năng giọng nói, bộ nhớ và máy tính để bàn

Capri hỗ trợ trò chuyện bằng văn bản và giọng nói, bao gồm cụm từ đánh thức tùy chọn “Hey Capri”. Cô ấy có thể phản hồi bằng 80 ngôn ngữ và nói bằng giọng miễn phí của mình, mô hình giọng nói do bạn cung cấp hoặc các dịch vụ được hỗ trợ như Fish Audio, ElevenLabs và OpenAI.

Theo mô tả dự án, ứng dụng có thể lưu giữ các cuộc trò chuyện trước đây và thông tin mà nó nhìn thấy trên màn hình máy tính của bạn. Vì README cho biết các chi tiết chính xác về việc xử lý dữ liệu vẫn đang được ghi chép, hãy xem lại chính sách quyền riêng tư của nhà cung cấp được kết nối và tránh để lộ thông tin nhạy cảm.

Capri cũng có giao diện theo chủ đề cyberpunk, một nhân vật trên máy tính để bàn có thể ngồi trên cửa sổ hoặc gần cuối màn hình, cùng trình phát nhạc mini cho Windows.

Hỗ trợ hiện tại và lộ trình

Các engine hiện được hỗ trợ là Claude Code, Codex và Antigravity. Các trợ lý khác có thể sử dụng thông qua adapter tùy chỉnh. Trình cài đặt Windows, ứng dụng portable, nhiều engine AI và điều khiển bằng giọng nói được đánh dấu là đã hoàn thành trong lộ trình.

Các hạng mục dự kiến bao gồm phiên bản macOS và Linux, hệ thống plugin, trình lập lịch tác vụ, ứng dụng đồng hành trên di động và thư viện chủ đề cyberpunk do cộng đồng đóng góp. Nếu bạn có yêu cầu tính năng, hãy gửi yêu cầu thông qua trình theo dõi vấn đề của dự án.

Kết luận

Capri AI biến các trợ lý lập trình được hỗ trợ thành một tác nhân tập trung trên máy tính để bàn, có thể làm việc với tệp, dự án, ứng dụng, mã, cuộc trò chuyện bằng giọng nói và các tính năng tự động hóa. Để bắt đầu, hãy tải bản phát hành Windows, kết nối một trợ lý, giới hạn quyền truy cập và bắt đầu bằng một tác vụ nhỏ mà bạn có thể dễ dàng kiểm tra. Như với mọi tác nhân trên máy tính để bàn, kết quả tốt nhất đến từ hướng dẫn rõ ràng, phê duyệt cẩn thận và bản sao lưu đáng tin cậy.

Capri là một dự án độc lập, không chính thức do người hâm mộ thực hiện, với phong cách cyberpunk lấy cảm hứng từ Cyberpunk: Edgerunners. Dự án không liên kết hoặc được CD PROJEKT RED, Studio Trigger, Netflix hay bất kỳ chủ sở hữu quyền nào khác liên kết xác nhận.