关于 zai-cli
zai-cli 是访问 Z.AI 能力的命令行工具，适合需要图像与视频分析、网页检索或 GitHub 代码查询的用户。它还支持检查和直接调用 MCP 工具，以及用 TypeScript 串联工具。
主要功能
- 01分析图像、截图和视频
- 02实时网页搜索
- 03将网页提取为 Markdown
- 04搜索和读取 GitHub 代码
- 05检查并调用 MCP 工具
- 06使用 TypeScript 串联工具
适用场景
- 01检查截图中的错误
- 02查找网页上的最新信息
- 03将文档页面提取为 Markdown
- 04搜索 GitHub 仓库
MCP 相关
它可列出 MCP 工具、显示工具架构并直接调用工具，也可通过 TypeScript 代码串联工具。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/zai-cli确认已加载。
附带文件references/advanced.md
详细介绍
ZAI CLI
通过 npx zai-cli 使用 Z.AI 功能。CLI 提供自我说明，可在任意层级使用 --help。
设置
export Z_AI_API_KEY="your-api-key"
在此获取密钥：https://z.ai/manage-apikey/apikey-list
命令
| 命令 | 用途 | 帮助 |
|---|---|---|
| vision | 分析图像、屏幕截图和视频 | --help 查看 8 个子命令 |
| search | 实时网页搜索 | --help 查看筛选选项 |
| read | 将网页内容获取为 Markdown | --help 查看格式选项 |
| repo | GitHub 代码搜索与读取 | --help 查看 tree/search/read |
| tools | 列出可用的 MCP 工具 | |
| tool | 显示工具架构 | |
| call | 原始 MCP 工具调用 | |
| code | TypeScript 工具链式调用 | |
| doctor | 检查设置与连接状态 |
快速开始
# Analyze an image
npx zai-cli vision analyze ./screenshot.png "What errors do you see?"
# Search the web
npx zai-cli search "React 19 new features" --count 5
# Read a web page
npx zai-cli read https://docs.example.com/api
npx zai-cli read https://docs.example.com/api --with-images-summary --no-gfm
# Explore a GitHub repo
npx zai-cli repo search facebook/react "server components"
npx zai-cli repo search openai/codex "config" --language en
npx zai-cli repo tree openai/codex --path codex-rs --depth 2
# Check setup
npx zai-cli doctor
输出
默认：仅数据（原始输出，以提高令牌效率）。
使用 --output-format json 可将输出包装为 { success, data, timestamp }。
高级用法
关于原始 MCP 工具调用（tools、tool、call）、Code Mode 和性能调优（缓存/重试），
请参阅 references/advanced.md。
评论
支持 Markdown