zai-cli について
zai-cli は Z.AI の機能を利用するコマンドラインツールです。画像や動画の分析、ウェブ検索、GitHub のコード調査に使え、MCP ツールの確認や呼び出し、TypeScript による連携にも対応します。
主な機能
- 01画像・スクリーンショット・動画の分析
- 02リアルタイムのウェブ検索
- 03ウェブページの Markdown 取得
- 04GitHub コードの検索と閲覧
- 05MCP ツールの確認と呼び出し
- 06TypeScript によるツール連携
活用シーン
- 01スクリーンショット内のエラー確認
- 02ウェブ上の最新情報の検索
- 03ドキュメントページの Markdown 化
- 04GitHub リポジトリの検索
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 | 画像、スクリーンショット、動画を分析します | 8 個のサブコマンドについては --help を参照 |
| search | リアルタイムのウェブ検索 | フィルタリングオプションについては --help を参照 |
| read | ウェブページを Markdown として取得します | 形式オプションについては --help を参照 |
| repo | GitHub のコード検索と読み取り | ツリー／検索／読み取りについては --help を参照 |
| 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
出力
デフォルト：データのみ（トークン効率を高める生の出力）。
{ success, data, timestamp } でラップするには、--output-format json を使用します。
詳細
生の MCP ツール呼び出し（tools、tool、call）、Code Mode、パフォーマンスの調整（キャッシュ／再試行）については、
references/advanced.md を参照してください。
コメント
Markdown 対応