用途：zai-cli 提供对 Z.AI 能力的命令行访问，涵盖图像与视频分析、OCR、UI 转代码、实时网页搜索、网页内容提取以及 GitHub 代码探索，并可通过 MCP 协议集成到 Claude Code 中，用于 AI 驱动的内容分析。
主要能力：vision（视觉分析）、search（实时搜索）、read（网页提取）、repo（GitHub 代码探索）等子命令。默认输出为 data-only 原始数据以节省 token，使用 --output-format json 可得到 { success, data, timestamp } 包装格式。CLI 自带文档，任意层级可用 --help 查看选项。
使用方式：需 Node.js 18+，设置环境变量 Z_AI_API_KEY，API key 从 https://z.ai/manage-apikey/apikey-list 获取，并需能访问 Z.AI API 端点。步骤：获取 API key；export Z_AI_API_KEY="your-key"；运行 npx zai-cli doctor 验证配置；用 npx zai-cli --help 查看命令；尝试 vision、search、read、repo 等基础命令；对子命令使用 --help 查看详细选项。
适用场景：需要图像/视频分析、OCR、UI 转代码、实时网页搜索、网页内容提取或 GitHub 代码探索，并希望以 CLI 或 MCP 方式接入 Claude Code 的场景。
限制：需有效的 Z.AI API key 和网络访问；错误处理与示例分别见 ${CLAUDE_SKILL_DIR}/references/errors.md 和 ${CLAUDE_SKILL_DIR}/references/examples.md。具体收费、价格、平台支持范围等资料暂未提供。