Hub documentation
AIエージェント向けHugging Face CLI
AIエージェント向けHugging Face CLI
hf CLIは、エージェントをHugging Face Hubやエコシステムに接続するための優れた方法です。モデルの検索、データセットやバケットの管理、Spacesの起動、任意のコーディングエージェントからのジョブ実行などが可能です。
これは、CLIを使用するエージェントに関するクイックガイドです。より詳細な情報については、CLIリファレンス自体を参照してください。
CLIのインストール
hf CLIがインストールされ、最新の状態になっていることを確認してください。セットアップ手順については、CLIインストールガイドを参照してください。
推奨されるスタンドアロンインストーラーは、Claude Code の場所を含む CLI Skill をグローバルにインストールするため、エージェントは追加の手順なしでこれを認識します。スキップするには、--exclude-skill(Windows の場合は -ExcludeSkill)を渡します。
CLI Skillを追加します
Skills は、エージェントがツールを効果的に利用するために必要なコンテキストを提供します。スタンドアロンインストーラーは CLI Skill を自動的に追加します。pip や Homebrew を使用した場合、スキップした場合、または単一のプロジェクトにのみ必要とする場合は、手動でインストールしてください。Skills について詳しくは agentskills.io をご覧ください。
# install globally (available in all projects, works with Claude Code, Codex, Cursor,
# OpenCode, and any agent that loads skills from ~/.agents/skills)
hf skills add --global
# or install for the current project only
hf skills addSkill はローカルにインストールされている CLI のバージョンから生成されるため、アップグレードすると古いものになります。
hf updateはグローバルにインストールされた Skill を更新しますが、削除した Skill を再追加することはありません。hf skills update -gは Skill 自体を更新します。hfは、Skill が存在しない場合や古い場合、1 日 1 回通知します。この通知を無効にするには、HF_HUB_DISABLE_UPDATE_CHECK=1を設定してください。
代わりに、Claude Codeのプラグインシステム経由でインストールすることもできます。
claude /plugin marketplace add huggingface/skills /plugin install hf-cli@huggingface-skills
リソース
- CLI リファレンス - 完全なコマンドドキュメント
- トークン設定 - トークンを管理
- Jobs ドキュメント - コンピューティングジョブガイド