Skip to main content

Zilliz Claude Code Plugin Setup

This guide explains how to install and set up the Zilliz Plugin in Claude Code.

Prerequisites​

Setup Procedure​

1

Run Claude Code

bash
> claude
2

Open the plugin marketplace

bash
/plugin
3

Find and install the Zilliz Plugin

Go to the Discover tab and search for zilliz. Select the zilliz plugin to install it.

TqS3b4z7Ho9xcXxHJaIc7HTZn1e

If your environment does not support marketplace discovery, you may still be able to install the plugin by adding the Zilliz plugin marketplace manually.

Install by adding Zilliz Cloud plugin marketplace

  1. Run Claude Code

    bash
    > claude

  2. Add the Zilliz Plugin marketplace.

    bash
    /plugin marketplace add zilliztech/zilliz-plugin

  3. Install the plugin

    bash
    /plugin install zilliz@zilliztech/zilliz-plugin

Initial Setup​

After installation, run the quickstart wizard:

bash
/zilliz:setup

The wizard will guide you through:

1

Install Zilliz CLI.

The plugin requires the Zilliz CLI. If not installed, run:

bash
curl -fsSL https://zilliz.com/cli/install.sh | bash

Verify installation:

bash
zilliz --version
2

Authenticate.

Authenticate with your Zilliz Cloud account:

bash
zilliz auth login

This opens a browser for authentication. After login, your credentials are stored locally.

3

Connect to your cluster.

Configure your default cluster connection:

bash
zilliz context set --cluster-id <your-cluster-id>

Or let the plugin help you select from available clusters.

Verification​

Test the plugin with a simple command:

plaintext
You: "List my clusters"

The plugin should display your Zilliz Cloud clusters.

Troubleshooting​

  • Plugin shows "CLI not found"

    Solution: Install the Zilliz CLI:

    bash
    curl -fsSL https://zilliz.com/cli/install.sh | bash

  • Authentication fails

    Solution:

    1. Check your internet connection

    2. Verify your Zilliz Cloud account is active

    3. Try logging out and back in:

    bash
    zilliz logout
    zilliz login

  1. "No cluster configured"

    Solution: Set a default cluster:

    bash
    zilliz context set --cluster-id <cluster-id>

Next Steps​

Contact Sales
Ctrl I