# AI 에이전트를 위한 Hugging Face CLI

`hf` CLI는 에이전트를 Hugging Face Hub 및 생태계에 연결하는 훌륭한 방법입니다. 모델 검색, 데이터셋 및 버킷 관리, Spaces 시작, 작업 실행을 모든 코딩 에이전트에서 수행할 수 있습니다.

> [!TIP]
> CLI를 사용하는 에이전트에 대한 간단한 가이드입니다. 더 자세한 정보는 [CLI 참조 문서](https://huggingface.co/docs/huggingface_hub/guides/cli)를 참고하세요.

## CLI 설치

`hf` CLI가 설치되어 있고 최신 버전인지 확인하세요. 설치 방법은 [CLI 설치 가이드](https://huggingface.co/docs/huggingface_hub/guides/cli#getting-started)를 참고하세요.

권장되는 독립형 설치 프로그램은 Claude Code 위치를 포함하여 CLI Skill을 전역으로 설치하므로 에이전트가 추가 단계 없이 이를 사용할 수 있습니다. `--exclude-skill`(Windows의 경우 `-ExcludeSkill`)를 전달하여 설치를 건너뛰ebilirsiniz.

## CLI 스킬 추가

Skills는 에이전트가 도구를 효과적으로 사용할 수 있도록 필요한 컨텍스트를 제공합니다. 스탠드얼론 설치 프로그램은 CLI Skill을 자동으로 추가합니다. pip 또는 Homebrew를 사용했거나 설치를 건너뛰었거나 단일 프로젝트에 설치하려는 경우 수동으로 설치하세요. Skills에 대한 자세한 내용은 [agentskills.io](https://agentskills.io)에서 확인하세요.

```bash
# 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 add
```

> [!TIP]
> Skill은 로컬에 설치된 CLI 버전에서 생성되므로 업그레이드 시 구식이 됩니다. `hf update`는 전역으로 설치된 Skill을 새로고침하며, 제거한 Skill은 다시 추가하지 않습니다. `hf skills update -g`는 해당 Skill을 독립적으로 새로고침합니다. `hf`는 Skill이 없거나 구식인 경우 하루에 한 번 알림을 표시하며, `HF_HUB_DISABLE_UPDATE_CHECK=1`을 설정하면 이 알림을 비활성화할 수 있습니다.

또는 Claude Code 플러그인 시스템을 통해 설치할 수 있습니다:

```bash
claude
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills
```

## 리소스

- [CLI 참조](https://huggingface.co/docs/huggingface_hub/guides/cli) - 전체 명령 문서
- [토큰 설정](https://huggingface.co/settings/tokens) - 토큰 관리
- [Jobs 문서](https://huggingface.co/docs/huggingface_hub/guides/cli#hf-jobs) - Compute jobs 가이드