Hugging Face、エージェント最適化の「hf CLI」を公開——複雑な操作で最大6倍少ないトークン

Hugging Faceは2026年6月4日、同社のHubを操作するためのコマンドラインツール「hf CLI」を、コーディングエージェントでの利用を見据えて再設計したと発表しました。モデルやデータセットのダウンロード・アップロード、リポジトリやプルリクエストの管理などをターミナルから行えるツールで、人間とエージェントの双方が使いやすい形に作り変えられています。

図版: Hugging Faceの発表内容をもとに作成（出典: Hugging Face Blog）

エージェントも主要な利用者に

再設計の背景にあるのは、エージェントがHubの無視できない利用者になったという認識です。Hugging Faceの計測によると、2026年4月以降、Claude Codeからは約3.95万人が4860万回、Codexからは約3.48万人が3640万回のリクエストを送っていました。

人だけでなく、AIエージェントがコマンドを通じてHubを操作する場面が一気に増えたわけです。Hugging Faceは、こうした現実に合わせて、ツールの出力や挙動そのものを見直しました。

人間とエージェントで出力を自動で切り替え

hf CLIはバージョン1.9.0以降、エージェント向けの出力モードを備えます。CLAUDECODEやCODEX_SANDBOXといった環境変数を手がかりに、エージェントから実行されているかを自動で判定し、フラグの指定なしに表示を切り替えます。

人間向けには色付きの整った表を出す一方、エージェント向けには色装飾を省いたTSV形式で値を省略せずに返します。対話的な確認を求めず、失敗時には修正方法をメッセージに含めて即座に止まる「fail-fast」の作りです。同じ操作を再実行しても安全な冪等性も意識されており、エージェントが扱いやすい振る舞いに統一されています。

複雑な操作で最大6倍のトークン削減

効果は数字にも表れています。Hugging Faceのベンチマークによると、複数の手順を伴う複雑なタスクでは、curlやPython SDKを使う場合と比べてhf CLIは最大6倍少ないトークンで処理できたとしています。

成功率と安定性でも差が出ました。Claude Code（Sonnet 4.6）ではhf CLIのスコアが0.94でエラーは163回中2回だったのに対し、curl/SDKは0.84でエラー11回でした。Codex（GPT-5.5）でも、hf CLIが0.93でエラー3回、curl/SDKが0.92でエラー10回という結果です。単純な読み取りでは差が小さい場面もあるものの、手順が増えるほどCLIの効率が際立つ傾向が示されています。

導入も簡単で、コマンド体系も一貫

hf CLIは、導入のしやすさと操作の分かりやすさも重視しています。インストールは1行のコマンドで済み、macOSやLinux、Windowsに対応します。

コマンドは「リソース＋動詞」という一貫した形にそろえられ、hf models lsやhf repos createのように直感的に組み立てられます。listとlsのような別名も用意され、各コマンドのヘルプには貼り付けてそのまま試せる例が添えられます。さらに--dry-runで実行前に転送内容を確認できるため、人にとってもエージェントにとっても扱いやすくなっています。

ツール呼び出しを約3割減らす「Skill」

あわせて提供される「hf-cli」スキルは、エージェントが文脈として読み込む簡潔なコマンドリファレンスです。リリースごとに自動生成され、エージェントが--helpを何度も叩いて手探りする無駄を防ぎます。

Hugging Faceによると、このスキルを使うとタスクあたりのコマンド実行回数が、Claude Codeで10.4回から6.9回、Codexで10.1回から7.3回へと、およそ30%減ったとしています。エージェントを業務に組み込む開発者にとっては、同じ作業をより少ない手数とトークンで終えられる意味は大きく、まずは手元のエージェントにhf CLIとスキルを導入して効果を試す価値がありそうです。

Source Hugging Face Blog

Designing the hf CLI as an agent-optimized way to work with the Hub

We’re on a journey to advance and democratize artificial intelligence through open source and open science.