alt
Tài liệu dành cho nhà phát triển

Tài liệu dành cho nhà phát triển

CLI

Thiết lập tích hợp Alt từ dòng lệnh bằng một trình hướng dẫn tương tác.

CLI altalt hướng dẫn thiết lập MCP, REST API và webhook mà không thay thế cấu hình hiện có. Hãy chạy trong thư mục dự án bạn muốn kết nối:

npx
npx altalt

Yêu cầu Node.js 18 trở lên. npx tải gói CLI hiện tại cho lần chạy này; không cần cài đặt toàn cục.

Trình hướng dẫn thực hiện những gì

  1. 1

    Kết nối MCP

    Phát hiện Claude Code và Codex, cung cấp thiết lập Cursor, rồi kết nối máy chủ MCP được Alt lưu trữ qua OAuth trên trình duyệt. Xem MCP để cấu hình thủ công.

  2. 2

    Xác minh API và webhook

    Mở console tài khoản, xác minh API key bạn dán, lưu vào dự án hiện tại và có thể gửi sự kiện thử tới endpoint webhook đã chọn sau khi xác nhận.

  3. 3

    Bàn giao triển khai

    Sau khi xác nhận, chuyển cho coding agent một prompt dựa trên tài liệu dành cho nhà phát triển có thể đọc bằng máy. Nếu không có agent được hỗ trợ, CLI in prompt để bạn dán.

Chế độ và cờ

--mcp-onlyGiới hạn bước thiết lập ở MCP qua OAuth trên trình duyệt, sau đó vẫn đề nghị bàn giao cho agent.
--api-onlyGiới hạn bước thiết lập ở xác minh REST API và webhook, sau đó vẫn đề nghị bàn giao cho agent.
--print-promptIn prompt cho coding agent rồi thoát.
--devNhắm tới môi trường phát triển. Chỉ dùng cho QA trước phát hành.
--versionIn phiên bản CLI đã cài đặt.
--helpIn cách dùng lệnh và các cờ hiện có.

An toàn cấu hình và key

  • CLI xác minh key trước khi sửa file môi trường và lưu key dưới tên ALT_API_KEY trong thư mục dự án hiện tại.
  • Cấu hình Alt MCP hiện có không bị xóa hoặc ghi đè. Khi cần, OAuth được thêm song song dưới tên alt-oauth.
  • Bàn giao cho agent và gửi webhook thử đều cần xác nhận rõ ràng. Hãy xem cách quản lý key trong Bảo mật trước khi triển khai.

Phạm vi cung cấp hiện tại

Gói CLI được công khai, nhưng OAuth production và việc phát hành API key hiện chỉ dành cho quản trị viên Alt trong giai đoạn dogfooding. Kết nối MCP bằng API key hiện có vẫn được hỗ trợ. Nếu console trả về 404 hoặc không thể phê duyệt OAuth, tài khoản của bạn chưa được bật.