Apache-2.0 の Python CLI で、火山方舟 MaaS プラットフォームをローカル Agent が呼び出せるツールセットに変えます——テキスト / マルチモーダル対話、Seedream / Seedance メディア生成、動画要約、ファインチューニング、ワンクリック Endpoint デプロイ、そして利用量・請求・`doctor` 診断に対応。
DSH 統合
互換
作者による申告
安全性監査
未監査
最終検証日
2026-08-25
ライセンス
Apache-2.0
01どんなタスクに使えるのか？
ローカル AI Agent に火山方舟モデルを呼ばせ、テキスト対話・マルチモーダル理解・画像 / 動画生成を行う
テキストおよびマルチモーダル対話の応答、動画要約、そしてローカルに自動保存される Seedream / Seedance の画像・動画
Claude Code / OpenCode / Codex などのローカル Agent を使い、方舟の生成・理解能力を自分のワークフローに組み込みたい開発者
ベースモデルやカスタムモデルをワンクリックで呼び出し可能な Endpoint にデプロイする
公開された Endpoint（`arkcli infer endpoint` で一覧・照会可能）と、ファインチューニングで得たカスタムモデル
方舟モデルをオンラインサービスとして提供したいエンジニアやプラットフォームチーム
方舟リソースの利用量・請求を確認し、読み取り専用の診断を実行する
利用量の統計、請求の一覧、および `doctor` の診断結果（エラーコード / メトリクス）
コスト監視、呼び出し失敗の切り分け、監視メトリクスの確認を行う運用担当者や開発者
02DeepSeek Harness への導入方法
インストール手順
- 01
$ npm i -g @volcengine/ark-cli@latest
- 02
arkcli --version
- 03
arkcli auth login volc-sso
- 04
arkcli auth status
- 05
arkcli +connect
導入成功の確認
- arkcli --version
- arkcli auth status
03DSH 統合と能力の範囲
`arkcli +connect` で Ark Skills を導入し、`arkcli helper configure --with-mcp` で Ark CLI の MCP ツール群をローカル Harness（Codex など）へ接続することで、Agent が火山方舟のモデル・生成・診断を自然言語で呼び出せるようにします。
モデル呼び出し
テキスト / マルチモーダルのプロンプト（例: @photo.jpg、@demo.mp4）→テキスト対話、マルチモーダル理解、ストリーミング応答
画像 / 動画生成
テキスト生成指示（例: 「未来都市のポスターを生成」）→Seedream 画像と Seedance 動画。ローカルに自動保存される
生成された画像 / 動画はローカルのファイルシステムに自動保存されるマルチモーダル理解
画像 / 動画 / 音声 / ドキュメント→OCR、動画要約、音声書き起こし、字幕タイミング、ドキュメント項目抽出
ワンクリック Endpoint デプロイ
モデル名（例: doubao-seed-2-0-pro-260215）と Endpoint 名→`arkcli infer endpoint` で管理できる公開 Endpoint
04誰に向いているのか？使うべきでない場面は？
向いている用途
- Claude Code / OpenCode / Codex などのローカル Agent を使い、方舟の生成・理解能力を自分のワークフローに組み込みたい開発者
- 方舟モデルをオンラインサービスとして提供したいエンジニアやプラットフォームチーム
- コスト監視、呼び出し失敗の切り分け、監視メトリクスの確認を行う運用担当者や開発者
不向きな用途
- `plans buy` / `plans renew` は課金操作であり、Ark CLI は最初に利用規約と確認ステップを表示し、デフォルトでは自動的に課金しません。
05互換性・メンテナンス・セキュリティ上の注意
- `plans buy` / `plans renew` は課金操作であり、Ark CLI は最初に利用規約と確認ステップを表示し、デフォルトでは自動的に課金しません。
- `doctor` はデフォルトで読み取り専用の診断であり、リソースを変更しません。修復が必要な場合は確認フローを経て実行されます。
- `arkcli +connect uninstall` はローカル Agent に注入された `ark-` / `arkcli-` 接頭辞の Skills だけを削除し、`arkcli` コマンド自体はアンインストールしません。
Apache-2.0 · 活発にメンテナンス中（最新リリース v1.0.21、2026-08-24）
06よくある質問
Ark CLI のインストール方法は？
「`npm i -g @volcengine/ark-cli@latest`」を実行し、続けて「`arkcli --version`」で確認します。その後「`arkcli auth login volc-sso`」で火山方舟にログインすると、身分・プロファイル・API Key が自動設定されます。
Ark CLI はどうやって DeepSeek Harness に接続しますか？
「`arkcli +connect`」で Ark Skills を導入し、「`arkcli helper configure --with-mcp`」で Ark CLI の MCP ツール群をローカル Harness（例: Codex）へ注入することで、Agent が自然言語で方舟の能力を呼び出せるようになります。
Agent は Ark CLI で実際に何ができますか？
テキストおよびマルチモーダル対話、OCR / 動画要約 / 音声書き起こし、Seedream 画像生成と Seedance 動画生成（ローカル保存）、ファインチューニング、ワンクリック Endpoint デプロイ、利用量 / 請求 / `doctor` 診断などです。
課金コマンドは安全ですか——自動で請求されますか？
いいえ。`plans buy` / `plans renew` は課金操作であり、Ark CLI は最初に利用規約と確認ステップを表示し、デフォルトでは自動的に課金しません。
CLI を残したまま注入した Skills だけを片付けるには？
「`arkcli +connect uninstall`」はローカル Agent に注入された `ark-` / `arkcli-` 接頭辞の Skills だけを削除し、`arkcli` コマンド自体はアンインストールしません。
07関連する DSH ワークフロー
ruflo
by ruvnet
元祖エージェントメタハーネス。知能マルチプレイヤー・スウォームの展開、自律ワークフロー連携、対話型AIシステムの構築に対応。適応メモリ、自己学習、RAG統合、Claude Code／Codex／Hermesネイティブ連携を備える。
reactive-resume
by amruthpillai
プライバシーに配慮した無料のオープンソース履歴書ビルダー
everos
by evermind-ai
すべての AI エージェント向けポータブルメモリ層。ローカルファースト、Markdown ネイティブ、ユーザー所有、アプリ横断で自己進化
yao
by yaoapp
エージェントとワークスペースを一か所に集約し、デスクトップ・モバイル・ブラウザ・API からタスクをボード管理できるセルフホスト型アプリ
08データと出典
配置 Harness / MCP，让本地 Agent 调用方舟能力
arkcli helper configure codex --with-mcp
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-25。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。