> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Assistant

> 고급 모델과 온디바이스 지능을 활용하여 자연어로 콘텐츠를 이해하고 작업하세요.

Craft Assistant는 Craft 안에서 함께하는 생각 파트너입니다. 자연어로 콘텐츠를 이해하고, 아이디어를 탐색하고, 정보를 요약하고, 워크스페이스를 탐색할 수 있도록 도와줍니다. 문서와 스페이스에서 직접 작업을 실행하기도 합니다. 콘텐츠 추가 및 교체, 스타일 적용, 섹션 재구성, 페이지 생성, 콘텐츠 이동, 불필요한 항목 삭제, 구조화된 결과물 생성 등을 수행할 수 있습니다.

AI가 일상적인 도구에 더욱 깊이 통합됨에 따라 **데이터와 컨텍스트가 그 어느 때보다 중요해졌습니다**. Craft는 **콘텐츠는 사용자의 것**이라는 원칙 위에 구축되었으며, 이 원칙이 Craft Assistant의 모든 결정을 이끌어 왔습니다.

## 정보를 다루는 새로운 방식

지금까지 소프트웨어는 대부분 수동으로 정리하고 수동으로 실행해야 했습니다. 먼저 정보를 찾고, 그 다음 직접 작업을 수행해야 했죠.

Craft Assistant가 이를 바꿉니다.

다음과 같은 질문을 물어볼 수 있습니다.

* *"지난해쯤 이 주제에 대해 무엇을 작성했나요?"*
* *"프로젝트 Y에서 아직 완료하지 못한 작업이 무엇인가요?"*
* *"신규 직원 온보딩과 관련된 모든 메모를 요약해 주세요."*

이제는 Craft에서 직접 작업 실행도 요청할 수 있습니다.

* 전체 문서 또는 섹션 재구성
* 콘텐츠 스타일 적용, 블록 추가·교체·제거
* 스페이스에 페이지 및 폴더 생성
* 워크스페이스를 더 잘 구성하기 위해 기존 콘텐츠 이동
* 태그 기반 요약 페이지를 포함한 요약 페이지 생성

단순한 생성 도구가 아닙니다. 기존 Craft 구조 안에서 깊이 작업할 수 있는 어시스턴트입니다.

Craft에 저장된 모든 것이 이제 **질문 하나만으로**, 그리고 점점 더 **실행 하나만으로** 가능해집니다.

## 두 가지 모드: Explore와 Execute

Assistant에는 문서 작업을 위한 두 가지 모드가 있습니다.

* **Explore** — 변경 사항을 제안하고 수정 전에 승인을 기다립니다.
* **Execute** — 변경 사항을 직접 적용합니다. 편집 내용이 실시간으로 표시됩니다.

Assistant 패널 하단의 모드 선택기를 사용하여 전환할 수 있습니다. **Fast** 및 **Max** 모델만 편집을 지원합니다. 자세한 내용은 [Craft Assistant로 편집하기](/ko/ai-assistant/editing)를 참고하세요.

## Craft Assistant 사용 가능 위치

Craft Assistant는 **macOS, iOS, Windows, Web**에서 사용할 수 있으며, 문서, 작업, 캘린더, 컬렉션, 코드 편집기, 브라우즈 뷰에서 작동합니다. 편집 기능은 현재 macOS와 iOS에서 사용할 수 있으며, 더 많은 플랫폼에서도 곧 제공될 예정입니다. 플랫폼별 세부 정보는 [Craft Assistant 사용하기](/ko/ai-assistant/using)를 참고하세요.

## 데이터는 항상 사용자의 것

4년 전, 우리는 매니페스토를 발표했습니다. *데이터는 사용자의 것입니다.*

그 약속은 변하지 않았습니다. 오히려 AI로 인해 더욱 중요해졌습니다.

Craft Assistant는 **프라이버시 우선** 접근 방식을 기반으로 구축되었습니다.

* 채팅 세션은 **기기 간에 동기화**되므로 어디서든 대화를 이어갈 수 있습니다.
* Craft는 연속성을 위해 세션 데이터를 동기화합니다. 콘텐츠를 AI 모델 학습에 **사용하지 않습니다**.
* 단일 요청 처리에 필요한 최소한의 데이터만 모델 제공업체에 전송됩니다.
* 적절한 비용 및 AI 사용량 추적을 위해 **토큰 사용량과 비용**만 기록하며, 텍스트나 요청 내용은 기록하지 않습니다.

다른 플랫폼은 데이터를 가두지만, Craft는 그렇지 않습니다.

## Craft Assistant 모델

Craft Assistant는 클라우드 모델 — **Core**, **Fast**, **Max** — 과 기기에서 무료로 실행되는 **Local** 모델을 제공합니다. Fast와 Max만 편집을 지원합니다. 전체 비교는 [AI 모델 선택하기](/ko/ai-assistant/models)를 참고하세요.

## AI 사용량: 투명하고, 선택적이며, 예측 가능하게

AI에는 실제 컴퓨팅 비용이 따르지만, 모든 사용자가 같은 수준의 AI 지원을 원하거나 필요로 하지는 않습니다.

가격을 올리거나 모든 사람을 더 높은 등급으로 강제하는 대신, 모든 플랜에 **AI 사용 할당량**이 포함됩니다. On-device 모델은 항상 무료이며, 필요하면 추가 구매도 가능합니다. 플랜별 세부 정보 및 가격은 [사용량 및 제한](/ko/ai-assistant/usage)을 참고하세요.

## 자신만의 방식으로 AI 활용하기, Craft 외부에서도

외부 AI 어시스턴트로 노트를 검색하고, 문서를 요약하고, 콘텐츠를 다시 Craft에 저장하세요. ChatGPT, Claude 등 호환 도구와의 연결은 [MCP](/ko/integrate/mcp)를 참고하세요.

커스텀 통합 및 자동화는 [Craft API](/ko/integrate/api)를 이용하세요.

<Info title="MCP 및 API 사용량">
  MCP 및 API 사용량은 AI 사용 할당량에 포함되지 않습니다. 모든 사람의 안정적인 이용을 위해 공정 이용 한도 내에서 사용해야 합니다. 무료 사용자와 유료 사용자의 한도가 다를 수 있지만, 핵심 기능은 모든 사용자에게 제공됩니다.
</Info>

## 자주 묻는 질문

### Craft Assistant가 문서를 편집할 수 있나요?

네. **Execute** 모드에서 Assistant는 콘텐츠 추가, 스타일 적용, 하위 페이지 생성, 문서 재구성 등을 수행할 수 있습니다. **Explore** 모드에서는 변경 사항을 제안하고 수정 전에 승인을 기다립니다. 편집에는 **Fast** 또는 **Max** 모델이 필요하며 macOS와 iOS에서 사용할 수 있습니다. [Craft Assistant로 편집하기](/ko/ai-assistant/editing)를 참고하세요.

### On-device 모델은 무료로 사용할 수 있나요?

네. 항상 무료이며 사용 할당량에 포함되지 않습니다.

### Assistant를 비활성화할 수 있나요?

네. 설정에서 스페이스별로 끌 수 있습니다.

### Craft가 채팅을 저장하나요?

Craft는 연속성을 위해 기기 간에 세션을 동기화합니다. 콘텐츠는 AI 모델 학습에 사용되지 않습니다.

### 내 ChatGPT 또는 Claude 구독을 대신 사용할 수 있나요?

네. [ChatGPT의 Craft 플러그인](/ko/integrate/mcp#use-craft-with-chatgpt) 또는 Claude와의 MCP 연결을 Craft AI 할당량 없이 사용할 수 있습니다.

## 관련 문서

<CardGroup cols={2}>
  <Card title="Craft Assistant 사용하기" href="/ko/ai-assistant/using">
    대화 시작 및 Assistant와 작업하는 방법 알아보기
  </Card>

  <Card title="AI 모델 선택하기" href="/ko/ai-assistant/models">
    속도, 기능, AI 사용량에 맞는 모델 선택
  </Card>

  <Card title="Craft Assistant로 편집하기" href="/ko/ai-assistant/editing">
    문서에서 직접 변경 사항 적용하기
  </Card>

  <Card title="커스텀 프롬프트" href="/ko/ai-assistant/custom-prompts">
    일관된 결과를 위한 재사용 가능한 지침 만들기
  </Card>

  <Card title="Help Agent" href="/ko/ai-assistant/help-agent">
    앱을 벗어나지 않고 Craft에 대한 즉각적인 답변 받기
  </Card>

  <Card title="텍스트 서식" href="/ko/write-and-edit/formatting">
    AI로 문서의 글쓰기와 서식 향상하기
  </Card>

  <Card title="문서 스타일링" href="/ko/write-and-edit/styling">
    AI 생성 콘텐츠에 아름다운 비주얼 스타일 적용하기
  </Card>

  <Card title="컬렉션" href="/ko/organize-and-find/collections">
    AI로 구조화된 데이터를 이해하고 분석하기
  </Card>
</CardGroup>


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