AI 에이전트용 Hugging Face CLI

hf CLI는 에이전트를 Hugging Face Hub와 생태계에 연결하는 아주 좋은 방법이에요. 모델을 검색하고, 데이터셋과 버킷을 관리하고, Spaces를 실행하고, 어떤 코딩 에이전트에서든 작업(job)을 돌릴 수 있죠.

출처: 문서

본문

[!TIP] CLI를 사용하는 에이전트를 위한 빠른 가이드예요. 더 자세한 정보는 CLI 레퍼런스를 참고하세요.

CLI 설치

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

권장되는 독립형 인스톨러는 CLI Skill을 전역으로 설치하며, Claude Code 위치까지 포함해 에이전트가 별다른 추가 단계 없이 이 스킬을 사용할 수 있게 해줘요. 건너뛰려면 --exclude-skill(Windows에서는 -ExcludeSkill)을 넘기면 돼요.

CLI Skill 추가

Skill은 에이전트가 도구를 효과적으로 사용하는 데 필요한 컨텍스트를 제공해요. 독립형 인스톨러가 CLI Skill을 자동으로 추가해 주지만, pip나 Homebrew로 설치했거나 건너뛰었거나 단일 프로젝트에만 넣고 싶다면 직접 설치해야 해요. Skill에 대한 자세한 내용은 agentskills.io에서 확인할 수 있어요.

# 전역 설치 (모든 프로젝트에서 사용 가능하며 Codex, Cursor, OpenCode,
# 그리고 ~/.agents/skills에서 스킬을 불러오는 모든 에이전트와 호환)
hf skills add --global

# Claude Code에서는 --claude 플래그 사용
hf skills add --claude --global

# 또는 현재 프로젝트에만 설치 (Codex, Cursor, OpenCode,
# 그리고 .agents/skills에서 스킬을 불러오는 모든 에이전트와 호환)
hf skills add

# Claude Code에서는 --claude 플래그 사용
hf skills add --claude

[!TIP] Skill은 로컬에 설치된 CLI 버전에서 생성되므로, CLI를 업그레이드하면 낡아버려요. hf update는 전역으로 설치된 Skill을 새로고침하고(제거한 것은 다시 추가하지 않음), hf skills update -g는 스스로 새로고침해요. Skill이 없거나 낡았다면 hf가 하루에 한 번 알려주는데, 이 알림을 끄려면 HF_HUB_DISABLE_UPDATE_CHECK=1을 설정하면 돼요.

Claude Code 플러그인 시스템으로도 설치할 수 있어요.

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

리소스

CLI 레퍼런스 - 전체 명령 문서
토큰 설정 - 토큰 관리
Jobs 문서 - 컴퓨팅 작업 가이드

더 알아보기 (Learn more)

CLI Skill은 설치된 CLI 버전에서 생성되므로 업그레이드 후 hf update로 새로고침하는 걸 잊지 마세요. --claude 플래그는 Claude Code 전용, --global은 전역 설치용이라는 점을 구분해 쓰면 돼요.