Skip to main content

Zilliz Plugin Troubleshooting

This page lists the common issues you may encounter while using the Zilliz Plugin.

Issue 1: "CLI not found" error​

Symptoms: Plugin reports it cannot find the Zilliz CLI

Solution:

  1. Install the CLI: pip install zilliz-cli

  2. Verify installation: zilliz --version

  3. Restart Claude Code

Issue 2: Authentication fails​

Symptoms: "Not authenticated" or "Invalid credentials"

Solution:

  1. Run zilliz auth login in terminal

  2. Complete browser authentication

  3. Verify with zilliz auth status

Issue 3: "No cluster configured"​

Symptoms: Commands fail with "no default cluster"

Solution:

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

Issue 4: Permission denied errors​

Symptoms: Operations fail with permission errors

Solution:

  1. Check your user role in the Zilliz Cloud console

  2. Verify the API key has the required permissions

  3. Contact your organization admin

Issue 5: Plugin commands are slow​

Symptoms: Long wait times for responses

Solution:

  1. Check your internet connection

  2. Verify cluster is not suspended

  3. Try smaller batch operations

Getting Support​