Zai Cli

Overview

ZAI CLI provides access to Z.AI capabilities including image/video analysis, real-time web search, web page extraction, and GitHub code exploration. It integrates with Claude Code via MCP protocol for seamless AI-powered content analysis.

Prerequisites

Node.js 18+ installed
Z_AI_API_KEY environment variable set
API key from https://z.ai/manage-apikey/apikey-list
Network access to Z.AI API endpoints

Instructions

Obtain an API key from Z.AI platform
Export your API key: export Z_AI_API_KEY="your-key"
Run npx zai-cli doctor to verify setup
Use npx zai-cli --help to see available commands
Try basic commands like vision, search, read, or repo
Use --help on any subcommand for detailed options

Access Z.AI capabilities via npx zai-cli. The CLI is self-documenting - use --help at any level.

Output

Default: data-only (raw output for token efficiency). Use --output-format json for { success, data, timestamp } wrapping.

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

zai-cli