> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI와 함께 빌드하기

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

# AI와 함께 빌드하기

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

### 지원 코딩 에이전트

> **Claude Code**

> **Cursor**

> **Codex**

> **Windsurf**

> **Gemini CLI**

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

***

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

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

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

![Anthropic](https://cdn.simpleicons.org/anthropic/D97706)

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

```shell theme={null}
/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins
/reload-plugins
```

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

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

**npx (모든 에이전트)**

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

```shell theme={null}
npx skills add crewaiinc/skills
```

[skills.sh 레지스트리](https://skills.sh/crewaiinc/skills)에서 가져옵니다.

**1. 공식 스킬 팩 설치**

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

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

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

* **Flow** — 상태ful 앱, 단계, crew 킥오프
* **Crew 및 에이전트** — JSON-first 패턴(`crew.jsonc`, `agents/*.jsonc`), 역할, 태스크, 위임
* **도구 및 통합** — 검색, API, MCP 서버, 일반적인 CrewAI 도구
* **프로젝트 레이아웃** — CLI 스캐폴드와 저장소 관례
* **최신 패턴** — 현재 CrewAI 문서와 모범 사례 반영

**3. 빌드 시작**

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

> **[Skills 개념](https://docs.crewai.com/ko/concepts/skills.md)**
>
> CrewAI 에이전트에서 스킬이 동작하는 방식 — 주입, 활성화, 패턴.

> **[Skills 랜딩 페이지](https://docs.crewai.com/ko/skills.md)**
>
> crewAIInc/skills 팩 개요와 포함 내용.

> **[AGENTS.md 및 코딩 도구](https://docs.crewai.com/ko/guides/coding-tools/agents-md.md)**
>
> Claude Code, Codex, Cursor, Gemini CLI용 AGENTS.md 설정.

> **[Skills 레지스트리 (skills.sh)](https://skills.sh/crewaiinc/skills)**
>
> 공식 목록 — 스킬, 설치 통계, 감사 정보.

***

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

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

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

**llms.txt란?**

[`llms.txt`](https://llmstxt.org/)는 문서를 대규모 언어 모델이 소비하기 쉽게 만드는 새로운 표준입니다. 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를 스캐폴딩하고 테스트합니다.

```bash theme={null}
crewai create crew my_crew
cd my_crew
crewai run
```

**2. 배포 준비**

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

```bash theme={null}
crewai deploy --prepare
```

구조와 요구 사항은 [준비 가이드](https://docs-platform.crewai.com/platform/ko/guides/prepare-for-deployment)를 참고하세요.

**3. AMP에 배포**

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

```bash theme={null}
crewai deploy
```

[GitHub 연동](https://docs-platform.crewai.com/platform/ko/guides/deploy-to-amp) 또는 [Crew Studio](https://docs-platform.crewai.com/platform/ko/guides/enable-crew-studio)로도 배포할 수 있습니다.

**4. API로 접근**

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

```bash theme={null}
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에 배포](https://docs-platform.crewai.com/platform/ko/guides/deploy-to-amp)**
>
> 전체 배포 가이드 — CLI, GitHub, Crew Studio 방법.

> **[AMP 소개](https://docs-platform.crewai.com/platform/ko/introduction)**
>
> 플랫폼 개요 — 프로덕션 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 살펴보기 →](https://app.crewai.com)**
>
> 가입하고 첫 crew를 프로덕션에 배포해 보세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.