AI 에이전트를 위한 Hugging Face CLI

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

CLI를 사용하는 에이전트에 대한 간단한 가이드입니다. 더 자세한 정보는 CLI 참조 문서를 참고하세요.

CLI 설치

hf CLI가 설치되어 있고 최신 버전인지 확인하세요. 설치 방법은 CLI 설치 가이드를 참고하세요.

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

CLI 스킬 추가

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 add

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

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

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

리소스

• CLI 참조 - 전체 명령 문서
• 토큰 설정 - 토큰 관리
• Jobs 문서 - Compute jobs 가이드