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

> claude
2

Open the plugin marketplace

/plugins
3

Find the Zilliz Plugin

Go to the Discover tab and search for zilliz

TqS3b4z7Ho9xcXxHJaIc7HTZn1e

4

Install the plugin

Select the zilliz plugin from the marketplace to install it.

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

    > claude

  2. Add the Zilliz Plugin marketplace.

    /plugin marketplace add zilliztech/zilliz-plugin

  3. Install the plugin

    /plugin install zilliz@zilliztech/zilliz-plugin

Initial Setup​

After installation, run the quickstart wizard:

/zilliz:setup

The wizard will guide you through:

1

Install Zilliz CLI.

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

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

Verify installation:

zilliz --version
2

Authenticate.

Authenticate with your Zilliz Cloud account:

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:

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:

You: "List my clusters"

The plugin should display your Zilliz Cloud clusters.

Troubleshooting​

  • Plugin shows "CLI not found"

    Solution: Install the Zilliz CLI:

    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:

    zilliz logout
    zilliz login

  1. "No cluster configured"

    Solution: Set a default cluster:

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

Next Steps​