Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Bắt đầu tại đây

Trạng thái: Đang hoạt động Phạm vi: trạng thái hiện tại Xem xét lần cuối: 2026-09-16 Chủ sở hữu: ax-code runtime

Nếu README ở gốc là cách nhanh nhất để cài AX Code, trang này là cách nhanh nhất để hiểu nó.

Phiên bản và khả dụng

Hãy bắt đầu với AX Code Standard, phiên bản mã nguồn mở, miễn phí cho dùng cá nhân và thương mại. Dùng mô hình cục bộ hoặc đám mây; AX Engine cung cấp một đường suy luận cục bộ gốc trên các máy Mac Apple Silicon được hỗ trợ. Quyền hiện có, rà soát thay đổi và bằng chứng thực thi cục bộ vẫn là khả năng cốt lõi.

Business là một sản phẩm độc quyền đã lên kế hoạch cho quản trị tổ chức qua AX Trust và quy trình kinh doanh qua AutomatosX. Dùng Standard tại nơi làm việc tự nó không đòi hỏi giấy phép Business. Xem Standard và Business để biết chi tiết.

Trình cài đã ký và kho runtime có sẵn ẩn danh từ download.ax-code.com. Đọc hướng dẫn cài đặt và hướng dẫn nâng cấp và khôi phục. Tài liệu kỹ thuật công khai được lưu tại ax-code.app/vi/docs/, độc lập với quyền truy cập mã nguồn. Đã cài rồi? Mở một terminal trong dự án của bạn, chạy ax-code, rồi dùng /connect trong TUI để chọn nhà cung cấp. Hãy bắt đầu bằng một câu hỏi về dự án, yêu cầu một thay đổi nhỏ, và rà soát diff cùng các kiểm tra dự án trước khi commit. Dùng ax-code doctor nếu runtime đã cài cần chẩn đoán.

AX Code là gì

AX Code là một runtime lập trình bằng AI. Nó kết hợp:

• các tác nhân cho những việc lập trình khác nhau
• thực thi công cụ tường minh
• chọn mô hình và nhà cung cấp
• trạng thái phiên bền
• cô lập và quyền có thể cấu hình
• các bề mặt tích hợp như TUI, SDK, chế độ máy chủ và MCP

Điều đó quan trọng vì lập trình bằng AI chỉ hữu ích trong kho thật khi bạn kiểm soát được việc tác nhân được phép làm, giữ ngữ cảnh qua các phiên, và tái dùng cùng quy trình bên ngoài một cửa sổ trò chuyện duy nhất.

Giá trị đến từ đâu

AX Code tối ưu khoảnh khắc sau khi tác nhân kết thúc: quyết định có giữ những gì nó tạo ra hay không.

• Bằng chứng. Mỗi phiên được ghi thành nhật ký sự kiện có kiểu cộng ảnh chụp tệp, nên ax-code graph, compare, replay, risk và audit có thể dựng lại chuyện đã xảy ra sau khi hội thoại kết thúc.
• Xác minh. Ở nơi một cổng có thể thực thi — ứng viên arena, áp dụng tái cấu trúc có cổng — chính lệnh kiểm tra kiểu, lint và kiểm thử của kho quyết định kết quả có được chấp nhận hay không.
• Khả năng đảo ngược. Ảnh chụp khôi phục được theo từng bước, không chỉ theo phiên, từ một kho đối tượng Git nằm ngoài kho của bạn.
• Quyết định của bạn. AX Code xếp hạng, chấm điểm và báo cáo. Nó không hợp nhất thay bạn.

Chống lưng cho những điều đó: công cụ tường minh với quy tắc quyền và chế độ cô lập, phiên bền, AGENTS.md cho quy ước kho, khả năng mang nhà cung cấp, và một runtime đứng sau TUI, CLI, phần mở rộng VS Code, SDK, máy chủ không giao diện và các tích hợp MCP. Đó là nền móng chứ không phải lý do để chọn AX Code — xem Vì sao dùng AX Code.

Để xem chính các lệnh, xem Bằng chứng thực thi.

Mô hình tư duy

Hãy nghĩ AX Code như năm tầng:

1. Tầng nhà cung cấp: chọn backend mô hình bạn muốn chạy.
2. Tầng tác nhân: chọn đúng tác nhân cho việc, hoặc để định tuyến hỗ trợ.
3. Tầng công cụ: tác nhân hành động qua các công cụ tường minh chứ không phải khả năng ẩn.
4. Tầng phiên: hội thoại, quyết định và trạng thái được giữ lại.
5. Tầng điều khiển: cô lập, quyền và hành vi kiểm toán xác định ranh giới.

Phần còn lại của tài liệu ánh xạ lên các tầng đó.

Chọn đường tiếp theo

Tôi muốn thử nhanh

• Bắt đầu từ README ở gốc để cài và khởi chạy lần đầu.
• Các đường cài được hỗ trợ dùng runtime đã biên dịch:
  • Trình cài phát hành Bash cho macOS Apple Silicon và Linux: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • Lựa chọn Homebrew thay thế cho CLI trên macOS: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Trình cài phát hành GitHub cho PowerShell trên Windows: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Trình cài Bash không phải đường thiết lập Windows chuẩn.
• Các gói npm không còn là kênh cài hoặc nâng cấp được hỗ trợ. Xem Kênh cài đặt và runtime để biết chính sách nền tảng, nhãn runtime và ma trận trình khởi chạy cục bộ.
• Dùng /connect hoặc ax-code providers login để đặt một mô hình. Xem Nhà cung cấp và mô hình được hỗ trợ cho nhà cung cấp Cloud API, nhà cung cấp CLI, AX Engine và mã mô hình. Để đánh giá không mất phí, dùng Bắt đầu nhanh API bậc miễn phí.
• Chạy ax-code init sau khi mở một dự án thật để AGENTS.md ghi các quy ước cục bộ.
• Nếu bạn muốn ranh giới an toàn chặt hơn, hãy bật Chế độ Sandbox trước các sửa rộng hơn.

Tôi muốn dùng an toàn trong kho nhóm hoặc công ty

• AX Code khởi động với chế độ tự chủ bật và chế độ sandbox tắt: full-access với hệ thống tệp và truy cập mạng không hạn chế.
• Với việc nhóm, công ty, không đáng tin hoặc không giám sát, hãy bật --sandbox workspace-write (hoặc read-only) trước khi bắt đầu nhiệm vụ.
• Đọc Chế độ Sandbox để biết ranh giới thực thi.
• Đọc Chế độ tự chủ nếu tác nhân sẽ chạy không giám sát.
• Đọc Chính sách bảo mật để biết mô hình đe dọa và chi tiết lưu trữ thông tin xác thực.
• Đọc Tầng ngữ nghĩa nếu nguồn gốc và phát lại quan trọng với quy trình của bạn.

Tôi muốn nhúng hoặc tự động hóa

• Dùng điểm vào không giao diện hoặc gRPC của @defai-digital/ax-code-sdk để tích hợp ứng dụng TypeScript.
• Dùng Tương thích HTTP và OpenAPI cho ranh giới dịch vụ, máy khách đã sinh và hợp đồng OpenAPI có thẩm quyền.
• Dùng ax-code mcp add khi tác nhân cần công cụ hoặc dịch vụ bên ngoài.

Tôi muốn hiểu kho hoặc đóng góp phản hồi

• Đọc Hub tài liệu cho phần còn lại của tài liệu công khai.
• Đọc CONTRIBUTING.md để biết chính sách đóng góp bên ngoài hiện tại.

Khi AX Code có thể không hợp

AX Code cố ý hơn cả tự hoàn thành hoặc một hộp trò chuyện được lưu trữ. Nó có thể là quá nhiều nếu:

• Bạn chỉ cần gợi ý mã nội tuyến và không muốn tác nhân thực thi công cụ.
• Bạn cần trải nghiệm chỉ SaaS được lưu trữ, không có runtime cục bộ.
• Bạn không cần phiên bền, phát lại, tích hợp SDK/máy chủ, hoặc chỉ dẫn cấp kho.
• Bạn đang làm việc trong môi trường không cho phép tiến trình CLI cục bộ.

Trong những trường hợp đó, một trợ lý trình soạn thảo nhẹ hơn có thể đơn giản hơn. AX Code mạnh nhất khi tác nhân cần vận hành bên trong quy trình phát triển thật, với ranh giới điều khiển, tính liên tục và tích hợp.

Các lệnh đầu thường gặp

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok chỉ chạy qua Grok Build CLI. Chọn grok-build-cli trong /connect; AX Code gọi lệnh cục bộ grok và tái dùng đăng nhập/phiên CLI của nó. Nhà cung cấp API đám mây trực tiếp xai trước đây không còn được hỗ trợ.

Bản đồ tài liệu