> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Plugin Claude Code
> Cài đặt plugin Helius chính thức cho Claude Code — bao gồm các máy chủ MCP của Helius và DFlow cùng những kỹ năng Solana chuyên sâu, giúp Claude truy cập blockchain trực tiếp chỉ trong một bước.
Helius là công ty tiền mã hóa đầu tiên và hiện là công ty duy nhất có plugin Claude Code chính thức được liệt kê trong [thư mục plugin của Anthropic](https://claude.com/plugins/helius). Plugin này tích hợp mọi thứ bạn cần để phát triển trên Solana trong một lần cài đặt — các máy chủ MCP để truy cập blockchain trực tiếp, những kỹ năng chuyên sâu định hướng hành vi của Claude và các tệp tham chiếu chi tiết cho mọi sản phẩm Helius.
Tự động khởi động `helius-mcp` — 10 công cụ định tuyến để truy vấn blockchain, gửi giao dịch, quản lý webhook và nhiều tác vụ khác
Tự động khởi động DFlow MCP — các công cụ cung cấp thông tin chi tiết về API giao dịch, lược đồ phản hồi và ví dụ mã
Tất cả kỹ năng ở cùng một nơi, biến Claude thành chuyên gia Solana hoạt động trên hạ tầng của nhà cung cấp nhanh nhất Solana
## Cài đặt
Trong Claude Code, hãy thêm marketplace Helius:
```
/plugin marketplace add helius-labs/core-ai
```
Sau đó cài đặt plugin:
```
/plugin install helius@helius-labs
```
Chạy dưới dạng hai lệnh riêng biệt — `/plugin marketplace add` tự yêu cầu nguồn marketplace, vì vậy việc dán cả hai dòng cùng lúc sẽ không thành công.
Bạn có thể thực hiện các bước tương tự từ shell bằng `claude plugin marketplace add helius-labs/core-ai`, sau đó là `claude plugin install helius@helius-labs`.
### Kiểm thử cục bộ
```bash theme={"system"}
git clone https://github.com/helius-labs/core-ai.git
claude --plugin-dir ./core-ai/helius-plugin
```
## Thành phần đi kèm
### Máy chủ MCP
Plugin tự động khởi động hai máy chủ MCP khi Claude Code chạy:
| Máy chủ | Phương thức truyền tải | Chức năng cung cấp |
| -------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Helius** (`helius-mcp@latest`) | stdio | 10 công cụ định tuyến (`heliusAccount`, `heliusWallet`, `heliusAsset`, `heliusTransaction`, `heliusChain`, `heliusStreaming`, `heliusKnowledge`, `heliusWrite`, `heliusCompression`, `expandResult`) bao quát DAS API, RPC, webhook, truyền trực tuyến, phân tích ví, quy trình bắt đầu sử dụng, kiến thức Solana và tài liệu |
| **DFlow** (`pond.dflow.net/mcp`) | HTTP | Thông tin chi tiết về API giao dịch, lược đồ phản hồi và ví dụ mã cho các tích hợp DFlow |
Xem [Helius MCP](/docs/vi/agents/mcp) để biết danh mục công cụ đầy đủ.
### Kỹ năng
| Kỹ năng | Cách gọi | Chức năng |
| ------------------------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Build](/docs/vi/agents/skills/build) | `/helius:build` | Biến Claude thành chuyên gia phát triển Solana. Định tuyến đến đúng công cụ và tệp tham chiếu cho DAS, Sender, WebSockets, LaserStream, Webhook, Wallet API và nhiều thành phần khác. |
| [Phantom](/docs/vi/agents/skills/phantom) | `/helius:phantom` | Biến Claude thành chuyên gia xây dựng dApp frontend. Bao quát Phantom Connect SDK (React, React Native, trình duyệt), kiểm soát quyền truy cập bằng token, đúc NFT, thanh toán và kiến trúc frontend an toàn. |
| [Jupiter](/docs/vi/agents/skills/jupiter) | `/helius:jupiter` | Biến Claude thành chuyên gia xây dựng ứng dụng DeFi. Kết hợp các API của Jupiter (hoán đổi, cho vay, lệnh giới hạn, DCA) với hạ tầng Helius. |
| [DFlow](/docs/vi/agents/skills/dflow) | `/helius:dflow` | Biến Claude thành chuyên gia xây dựng ứng dụng giao dịch. Kết hợp các API của DFlow (hoán đổi giao ngay, thị trường dự đoán, truyền trực tuyến, KYC) với hạ tầng Helius. |
| [OKX](/docs/vi/agents/skills/okx) | `/helius:okx` | Biến Claude thành chuyên gia xây dựng ứng dụng giao dịch và phân tích thông tin. Kết hợp tính năng tổng hợp DEX, tín hiệu dòng tiền thông minh và phân tích meme của OKX với hạ tầng Helius. |
| [SVM](/docs/vi/agents/skills/svm) | `/helius:svm` | Chuyên gia giao thức Solana. Giải thích kiến trúc, cơ chế đồng thuận, công cụ thực thi, mô hình tài khoản và kinh tế học của trình xác thực bằng các nguồn trực tiếp. |
### Tệp tham chiếu
Tài liệu chuyên sâu đi kèm từng kỹ năng mà Claude đọc trước khi viết mã — bao quát DAS API, Sender, Phí ưu tiên, Webhook, WebSocket, LaserStream, Wallet API, Giao dịch nâng cao, quy trình bắt đầu sử dụng, Phantom Connect SDK (React, React Native, trình duyệt), kiểm soát quyền truy cập bằng token, đúc NFT, thanh toán, bảo mật frontend, Jupiter (Swap V2, Lend, Trigger, Recurring, Perps, Predictions, token/giá, Plugin), giao dịch giao ngay và thị trường dự đoán của DFlow, tính năng tổng hợp DEX và phân tích thông tin của OKX cũng như các mẫu tích hợp.
## Thiết lập khóa API
Plugin tự động khởi động máy chủ MCP, nhưng bạn vẫn cần khóa API Helius. Trong lần sử dụng đầu tiên, Claude sẽ hướng dẫn bạn theo một trong các cách sau:
Nếu đã có khóa từ [dashboard.helius.dev](https://dashboard.helius.dev), hãy yêu cầu Claude gọi hành động `setHeliusApiKey` trên `heliusAccount`:
Chỉ cần nói với Claude: "Đặt khóa API Helius của tôi thành `YOUR_API_KEY`"
Tạo tài khoản mới từ Claude Code qua liên kết thanh toán được lưu trữ hoặc tính năng thanh toán tự động. Mỗi bước là một hành động trên `heliusAccount`:
1. Claude gọi `heliusAccount` với `action: "generateKeypair"` — tạo ví Solana
2. Claude gọi `heliusAccount` với `action: "signup"` và `mode: "link"` — trả về URL thanh toán để bạn mở trong trình duyệt và thanh toán bằng bất kỳ ví nào (hoặc `mode: "autopay"` để tự động thanh toán USDC từ cặp khóa cục bộ)
3. Sau khi thanh toán qua liên kết, Claude gọi `heliusAccount` với `action: "signup"` và `mode: "resume"` — hoàn tất việc cấp tài nguyên và tự động cấu hình khóa API
Sử dụng [Helius CLI](/docs/vi/agents/cli) từ terminal:
```bash theme={"system"}
npx helius-cli@latest keygen
npx helius-cli@latest signup --plan agent --email you@example.com --first-name Jane --last-name Doe # Print hosted payment link
# (pay in browser, then:)
npx helius-cli@latest signup --resume # Finalize account
# Or autopay from the local keypair:
npx helius-cli@latest signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe
```
**Khóa API DFlow:** Các điểm cuối REST dành cho phát triển hoạt động mà không cần khóa (có giới hạn tốc độ). Để sử dụng trong môi trường production hoặc truy cập WebSocket, hãy lấy khóa tại [pond.dflow.net/build/api-key](https://pond.dflow.net/build/api-key).
## Cách sử dụng
Sau khi cài đặt, hãy đặt câu hỏi bằng ngôn ngữ tự nhiên. Claude tự động chọn đúng công cụ và đọc đúng tệp tham chiếu:
* "Xây dựng giao diện hoán đổi bằng DFlow và Helius Sender"
* "Ví này sở hữu những NFT nào?"
* "Thiết lập webhook để giám sát các khoản chuyển đến ví của tôi"
* "Phân tích cú pháp giao dịch này: `5abc...`"
* "Xây dựng trình xem danh mục đầu tư hiển thị token sau khi kết nối Phantom"
* "Gửi 1 SOL đến `Gh9ZwEm...`"
* "Tạo giao diện giao dịch cho thị trường dự đoán"
## Cấu trúc plugin
Plugin chứa ba tệp cấp cao nhất và một thư mục `skills/`:
| Đường dẫn | Mục đích |
| ---------------------------- | --------------------------------------------------------------------- |
| `.claude-plugin/plugin.json` | Tệp kê khai plugin (tên: `"helius"`, v1.0.0) |
| `.mcp.json` | Cấu hình tự động khởi động cho các máy chủ MCP Helius + DFlow |
| `skills/build/` | `/helius:build` — `SKILL.md` + 9 tệp tham chiếu sản phẩm Helius |
| `skills/phantom/` | `/helius:phantom` — `SKILL.md` + 16 tệp tham chiếu (Phantom + Helius) |
| `skills/jupiter/` | `/helius:jupiter` — `SKILL.md` + 16 tệp tham chiếu (Jupiter + Helius) |
| `skills/dflow/` | `/helius:dflow` — `SKILL.md` + 12 tệp tham chiếu (DFlow + Helius) |
| `skills/okx/` | `/helius:okx` — `SKILL.md` + các mẫu tích hợp (OKX + Helius) |
| `skills/svm/` | `/helius:svm` — `SKILL.md` + 10 tệp tham chiếu kiến trúc |
Duyệt toàn bộ mã nguồn trên [GitHub](https://github.com/helius-labs/core-ai/tree/main/helius-plugin).
## Tìm hiểu thêm
Danh mục công cụ đầy đủ và cách thiết lập MCP độc lập
Thông tin chi tiết về kỹ năng phát triển Solana cốt lõi
Thông tin chi tiết về kỹ năng giao dịch và quy trình làm việc kết hợp
Mã nguồn và theo dõi sự cố