huggingface-cli download でダウンロードしたモデルのデフォルト保存先

Fri, 17 Apr 2026 14:48:04 +0800

Hugging Face のコマンドラインツールでモデルをダウンロードする場合、たとえば次のように実行します。

`1`	`huggingface-cli download <repo-id>`

ダウンロード後、モデルファイルは通常、現在のディレクトリには直接出てきません。Hugging Face のデフォルトキャッシュディレクトリに保存されます。

デフォルトのキャッシュ場所

huggingface-cli download は Hugging Face Hub のキャッシュ机制に従います。デフォルトのパスは次のとおりです。

システム	デフォルトキャッシュディレクトリ
Linux / macOS	`~/.cache/huggingface/hub`
Windows	`C:\Users\用户名\.cache\huggingface\hub`

Windows でユーザー名が knightli の場合、デフォルトディレクトリはおおよそ次のようになります。

`1`	`C:\Users\knightli\.cache\huggingface\hub`

これは正常な動作です。huggingface-cli download はデフォルトでリポジトリの内容をキャッシュディレクトリに保存し、あとで再利用できるようにします。毎回ダウンロードし直す必要がありません。

キャッシュディレクトリ内では、通常リポジトリごとに次のような構造が作られます。

`1`	`models--组织名--模型名`

たとえば、あるモデルリポジトリは次のようにキャッシュされることがあります。

`1`	`models--unsloth--gemma-4-E4B-it-GGUF`

実際のモデルファイルは、多くの場合そのキャッシュディレクトリ内の snapshots サブディレクトリにあります。

モデルファイルを自分で指定した場所に置きたい場合は、huggingface-cli download に --local-dir を付けます。

`1`	`huggingface-cli download <repo-id> --local-dir D:\models\<model-name>`

この方法は llama.cpp、Ollama、LM Studio などのローカル推論ツールと組み合わせる場合に便利です。あとからファイルを探しやすくなります。