AI와 함께 빌드하기

CrewAI로 빌드·배포·확장하는 데 필요한 모든 것 — 스킬, 기계가 읽을 수 있는 문서, 배포, 엔터프라이즈 기능을 AI 코딩 에이전트용으로 정리했습니다.

​

AI와 함께 빌드하기

CrewAI는 AI 네이티브입니다. 이 페이지는 Claude Code, Codex, Cursor, Gemini CLI 등 개발자가 crew와 flow를 배포하도록 돕는 코딩 에이전트가 CrewAI로 빌드할 때 필요한 내용을 한곳에 모았습니다.

​

지원 코딩 에이전트

Claude Code

Cursor

Codex

Windsurf

Gemini CLI

이 페이지는 사람과 AI 어시스턴트 모두를 위해 작성되었습니다. 코딩 에이전트라면 CrewAI 맥락은 Skills부터, 전체 문서 접근은 llms.txt를 사용하세요.

---

​

1. Skills — 에이전트에게 CrewAI 가르치기

Skills는 코딩 에이전트에게 Flow 스캐폴딩, Crew 구성, 도구 사용, 프레임워크 관례 등 CrewAI에 대한 깊은 지식을 담은 지침 묶음입니다.

Claude Code (플러그인 마켓플레이스)

CrewAI 스킬은 Claude Code 플러그인 마켓플레이스에서 제공됩니다. AI 네이티브 기업들이 쓰는 것과 같은 배포 채널입니다.

/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins
/reload-plugins

CrewAI와 관련된 질문을 하면 다음 네 가지 스킬이 자동으로 활성화됩니다.

스킬	실행 시점
getting-started	새 프로젝트 스캐폴딩, LLM.call() / Agent / Crew / Flow 선택, crew.py / main.py 연결
design-agent	에이전트 구성 — 역할, 목표, 배경 이야기, 도구, LLM, 메모리, 가드레일
design-task	태스크 설명, 의존성, 구조화된 출력(output_pydantic, output_json), 사람 검토
ask-docs	최신 API 정보를 위해 CrewAI 문서 MCP 서버 조회

npx (모든 에이전트)

Claude Code, Codex, Cursor, Gemini CLI 등 모든 코딩 에이전트에서 사용할 수 있습니다.

npx skills add crewaiinc/skills

skills.sh 레지스트리에서 가져옵니다.

1. 공식 스킬 팩 설치

   위 방법 중 하나를 사용하세요 — Claude Code 플러그인 마켓플레이스 또는 npx skills add. 둘 다 공식 crewAIInc/skills 팩을 설치합니다.

2. 에이전트가 즉시 CrewAI 전문성을 갖춤

   스킬 팩이 에이전트에게 알려 주는 내용:

   • Flow — 상태ful 앱, 단계, crew 킥오프
   • Crew 및 에이전트 — YAML 우선 패턴, 역할, 태스크, 위임
   • 도구 및 통합 — 검색, API, MCP 서버, 일반적인 CrewAI 도구
   • 프로젝트 레이아웃 — CLI 스캐폴드와 저장소 관례
   • 최신 패턴 — 현재 CrewAI 문서와 모범 사례 반영
3. 빌드 시작

   매 세션마다 프레임워크를 다시 설명하지 않아도 에이전트가 CrewAI 프로젝트를 스캐폴딩하고 빌드할 수 있습니다.

Skills 개념

CrewAI 에이전트에서 스킬이 동작하는 방식 — 주입, 활성화, 패턴.

Skills 랜딩 페이지

crewAIInc/skills 팩 개요와 포함 내용.

AGENTS.md 및 코딩 도구

Claude Code, Codex, Cursor, Gemini CLI용 AGENTS.md 설정.

Skills 레지스트리 (skills.sh)

공식 목록 — 스킬, 설치 통계, 감사 정보.

---

​

2. llms.txt — 기계가 읽을 수 있는 문서

CrewAI는 AI 어시스턴트가 전체 문서에 기계가 읽을 수 있는 형태로 바로 접근할 수 있도록 llms.txt 파일을 제공합니다.

https://docs.crewai.com/llms.txt

llms.txt란?

llms.txt는 문서를 대규모 언어 모델이 소비하기 쉽게 만드는 새로운 표준입니다. HTML을 스크래핑하는 대신, 필요한 내용이 담긴 하나의 구조화된 텍스트 파일을 가져올 수 있습니다.

CrewAI의 llms.txt는 이미 제공 중이며, 에이전트가 바로 사용할 수 있습니다.

사용 방법

CrewAI 참고 문서가 필요할 때 코딩 에이전트에 URL을 알려 주세요.

Fetch https://docs.crewai.com/llms.txt for CrewAI documentation.

Claude Code, Cursor 등 많은 코딩 에이전트가 URL을 직접 가져올 수 있습니다. 파일에는 CrewAI 개념, API, 가이드를 아우르는 구조화된 문서가 포함되어 있습니다.

왜 중요한가

• 스크래핑 불필요 — 한 번의 요청으로 깔끔한 구조화 콘텐츠
• 항상 최신 — docs.crewai.com에서 직접 제공
• LLM에 최적화 — 브라우저가 아니라 컨텍스트 윈도우에 맞게 포맷
• 스킬과 상호 보완 — 스킬은 패턴을, llms.txt는 참조를 제공

---

​

3. 엔터프라이즈에 배포

로컬 crew를 몇 분 안에 CrewAI AMP(Agent Management Platform) 프로덕션으로 가져가세요.

1. 로컬에서 빌드

   crew 또는 flow를 스캐폴딩하고 테스트합니다.

   crewai create crew my_crew
   cd my_crew
   crewai run
   
2. 배포 준비

   프로젝트 구조가 준비되었는지 확인합니다.

   crewai deploy --prepare
   

   구조와 요구 사항은 준비 가이드를 참고하세요.

3. AMP에 배포

   CrewAI AMP 플랫폼으로 푸시합니다.

   crewai deploy
   

   GitHub 연동 또는 Crew Studio로도 배포할 수 있습니다.

4. API로 접근

   배포된 crew는 REST API 엔드포인트를 받습니다. 모든 애플리케이션에 통합할 수 있습니다.

   curl -X POST https://app.crewai.com/api/v1/crews/<crew-id>/kickoff \
     -H "Authorization: Bearer $CREWAI_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"inputs": {"topic": "AI agents"}}'
   

AMP에 배포

전체 배포 가이드 — CLI, GitHub, Crew Studio 방법.

AMP 소개

플랫폼 개요 — 프로덕션 crew에 AMP가 제공하는 것.

---

​

4. 엔터프라이즈 기능

CrewAI AMP는 프로덕션 팀을 위해 만들어졌습니다. 배포 외에 제공되는 것은 다음과 같습니다.

관측 가능성

모든 crew 실행에 대한 상세 실행 추적, 로그, 성능 지표. 에이전트 결정, 도구 호출, 태스크 완료를 실시간으로 모니터링합니다.

Crew Studio

시각적으로 crew를 만들고, 맞춤 설정하고, 배포하는 노코드/로코드 인터페이스 — 코드로 보내거나 바로 배포할 수 있습니다.

웹훅 스트리밍

crew 실행에서 실시간 이벤트를 시스템으로 스트리밍합니다. Slack, Zapier 등 웹훅 소비자와 연동할 수 있습니다.

팀 관리

SSO, RBAC, 조직 단위 제어. 팀 전체에서 crew 생성·배포·접근 권한을 관리합니다.

도구 저장소

조직 전체에 맞춤 도구를 게시하고 공유합니다. 레지스트리에서 커뮤니티 도구를 설치합니다.

Factory(셀프 호스팅)

자체 인프라에서 CrewAI AMP를 실행합니다. 데이터 상주와 규정 준수 제어와 함께 플랫폼 전체 기능을 사용할 수 있습니다.

AMP는 누구를 위한 것인가요?

AI 에이전트 워크플로를 프로토타입에서 프로덕션으로 옮겨야 하는 팀을 위한 제품입니다. 관측 가능성, 접근 제어, 확장 가능한 인프라를 제공합니다. 스타트업이든 대기업이든 운영 복잡도는 AMP가 맡고, 에이전트 구축에 집중할 수 있습니다.

배포 옵션은 무엇이 있나요?

• 클라우드 (app.crewai.com) — CrewAI가 관리, 프로덕션까지 가장 빠른 경로
• Factory(셀프 호스팅) — 데이터 통제를 위해 자체 인프라에서 실행
• 하이브리드 — 민감도에 따라 클라우드와 셀프 호스팅을 혼합

CrewAI AMP 살펴보기 →

가입하고 첫 crew를 프로덕션에 배포해 보세요.