Claude Code 및 AI 에이전트와 함께 Felo Slides 사용하는 방법

June 25, 2026 · 약 21분

Committed to answers at your fingertips

Felo Slides를 Claude Code, OpenClaw, 그리고 felo-slides npm 패키지와 함께 사용하여 터미널에서 AI 기반 슬라이드를 생성하세요. 프로그래밍 방식으로 슬라이드를 생성하는 개발자용 가이드입니다.

$ npx felo-slides "Explain Kubernetes pod scheduling in 8 slides"
✓ 주제 분석 중...
✓ 개요 생성 중 (8 슬라이드)...
✓ 슬라이드 내용 작성 중...
✓ 프레젠테이션 빌드 중...
✔ 완료 → kubernetes-pod-scheduling.felo

끝입니다. 브라우저도, 드래그 앤 드롭도, 템플릿 선택도 필요 없습니다. 명령어 하나만 입력하면 여덟 장의 슬라이드가 생성됩니다.

만약 40분짜리 회의가 사실은 슬라이드 한 세트로 통했어야 한다고 느껴본 적 있다면, 왜 우리가 Felo Slides를 만들었는지 이미 알고 있을 겁니다. 하지만 이 글은 웹 앱 이야기가 아닙니다 — 개발자에게 API를 주고 “모든 걸 자동화하라”고 했을 때 어떤 일이 일어나는지에 관한 이야기입니다.

이제 Claude Code, OpenClaw 에이전트, 그리고 자신의 스크립트와 함께 Felo Slides를 사용해 터미널을 벗어나지 않고 AI 슬라이드를 생성하는 방법을 알아보겠습니다.

[IMG: 터미널에서 felo-slides CLI가 하나의 프롬프트로 프레젠테이션을 생성하는 스크린샷, 생성된 출력 파일이 강조 표시됨]

Felo Slides란? (개발자를 위한 설명)

Felo Slides는 AI 기반 프레젠테이션 엔진입니다. 대부분의 사람들은 slides.felo.ai 웹앱으로 알고 있지만, 그 내부에는 다음이 있습니다:

felo-slides npm 패키지 — 프로그래밍 방식으로 슬라이드를 생성하는 CLI 및 라이브러리
Claude Code Skill — Claude Code 내에서 프레젠테이션을 직접 생성할 수 있는 네이티브 스킬
OpenClaw Skill — OpenClaw 에이전트 프레임워크에 연결된 동일한 아이디어
REST API — 슬라이드 생성, 주제 분석, 템플릿 렌더링을 위한 HTTP 엔드포인트

웹앱은 다듬어진 프런트엔드이며, 개발자 도구들은 그 엔진입니다. CLI로 로컬 생성, API로 서버 자동화, Claude Code 스킬로 대화형 슬라이드 빌드를 조합해 사용할 수 있습니다.

사용 시점 가이드:

사용 사례	도구
터미널에서 빠르게 슬라이드 만들기	`felo-slides` CLI
에디터 내 대화형 생성	Claude Code Skill
에이전트 기반 워크플로우	OpenClaw Skill
백엔드 / CI / 배치 작업	Felo Slides API

설치 및 설정

사전 요구 사항

Node.js 18+ (20 이상 권장)
API 접근이 가능한 Felo 계정 (무료 요금제 가능)
slides.felo.ai/settings/api에서 발급받은 API 키

npm 패키지 설치

npm install -g felo-slides

또는 설치 없이 사용:

npx felo-slides "Your presentation topic here"

인증 설정

환경 변수로 API 키 설정:

export FELO_SLIDES_API_KEY=fsk_your_api_key_here

또는 프로젝트 루트에 .felo-slides.json 생성:

{
  "apiKey": "fsk_your_api_key_here",
  "defaultOutput": "./presentations",
  "template": "developer-dark"
}

작동 확인

$ felo-slides --version
felo-slides 2.4.0

$ felo-slides --check
✓ API 키 유효
✓ 속도 제한: 47/50 요청 남음
✓ 템플릿 로드됨: 12

[IMG: 터미널 출력을 나란히 비교한 이미지 — 성공적인 설정 vs 일반 인증 오류]

Claude Code와 함께 Felo Slides 사용하기

이제 흥미로운 부분입니다. Claude Code Skill을 사용하면 Claude의 에디터가 슬라이드 공장으로 변합니다. 프롬프트 입력과 복사 과정을 거치지 않고 Claude가 직접 생성, 수정, 내보내기를 수행합니다.

Claude Code Skill 설치

# Claude Code 프로젝트 디렉토리에서
claude skill add felo-slides

이 명령어는 Felo Slides 스킬을 Claude Code에 등록합니다. 이제 Claude는 프레젠테이션을 생성할 수 있다는 사실을 알고 전체 felo-slides API를 사용할 수 있습니다.

Claude Code에서 기본 사용법

설치 후 자연스럽게 요청해 보세요:

> Create a 10-slide deck about our Q3 engineering roadmap.
  Include sections on: platform migration, hiring plan,
  and infrastructure budget.

Claude는 다음을 수행합니다:

개요를 작성하고 구조를 확인
Felo Slides API를 통해 본문 생성
.felo 파일로 프로젝트 디렉토리에 저장
특정 슬라이드에 대한 수정 제안을 제공

컨텍스트 전환도 없고 복사 붙여넣기도 없습니다. 슬라이드는 코드와 함께 저장소에 존재합니다.

고급: Claude Code에서 사용자 정의 템플릿 사용

프로젝트별 슬라이드 템플릿을 정의해 Claude가 자동으로 사용할 수 있습니다:

mkdir -p .felo/templates

.felo/templates/engineering.json을 생성:

{
  "name": "Engineering Update",
  "theme": "dark",
  "accent": "#6366f1",
  "fonts": {
    "heading": "JetBrains Mono",
    "body": "Inter"
  },
  "layout": {
    "titleSlide": "code-hero",
    "contentSlide": "split-left",
    "closingSlide": "cta-minimal"
  }
}

그런 다음 Claude Code에서:

> Make a deck about the auth service migration.
  Use the engineering template.

Claude는 템플릿을 자동으로 적용하고 모든 슬라이드에 일관되게 반영합니다.

[IMG: Claude Code 에디터 대화창 — 사용자가 슬라이드 덱 요청, Claude가 개요 생성 후 .felo 파일이 파일 트리에 표시됨]

대화형 슬라이드 편집

Claude Code 통합의 진짜 강점은 반복적인 대화형 편집입니다:

> 3번 슬라이드가 너무 복잡해요. 두 개로 나눠주세요.
  아키텍처 다이어그램은 4번으로 옮겨주세요.

> 5~7번 슬라이드에 발표자 노트를 추가하고
  각 노트는 50단어 이하로 해주세요.

> 강조 색상을 브랜드 그린(#10b981)으로 바꾸고
  타이틀 슬라이드에 로고를 추가해주세요.

각 편집은 내부적으로 API 호출이지만, 사용자는 HTTP 요청을 볼 필요가 없습니다. Claude가 모두 처리합니다.

OpenClaw와 함께 Felo Slides 사용하기

OpenClaw는 에이전트 접근을 한 단계 더 확장합니다. Felo Slides OpenClaw Skill은 에이전트 워크플로우 중 일환으로 슬라이드를 자동 생성할 수 있게 해줍니다.

설정

openclaw skill install felo-slides

OpenClaw 워크스페이스에서 구성:

# openclaw.yaml
skills:
  felo-slides:
    apiKey: "${FELO_SLIDES_API_KEY}"
    defaultTemplate: "professional"
    outputDir: "./output/slides"

에이전트 기반 슬라이드 생성

OpenClaw에서 슬라이드 생성을 워크플로우 일부로 자동화할 수 있습니다:

User: 방금 Acme 계약을 성사시켰어요. 엔지니어링 킥오프
      덱을 준비해주세요. Notion의 프로젝트 개요와
      Linear의 타임라인을 사용하세요.

Agent: [Notion 개요 읽기]
       [Linear 타임라인 가져오기]
       [felo-slides로 12슬라이드 킥오프 덱 생성]
       [output/slides/acme-kickoff.felo로 저장]
       "완료. 범위, 일정, 팀 배정, 마일스톤을 포함한
        12장짜리 덱을 생성했습니다.
        #eng-general 채널에 전송할까요?"

에이전트는 두 개의 외부 도구에서 데이터를 가져와 하나의 프레젠테이션으로 구조화하고, 전체 슬라이드를 한 번에 생성합니다.

[IMG: OpenClaw 에이전트 워크플로 다이어그램 — 사용자 요청 → 컨텍스트 수집(Notion, Linear) → felo-slides API → 출력 파일 → 전달]

명령줄 예시

이제 CLI 사용법을 좀 더 살펴봅시다. 다음 예시들은 가장 일반적인 개발자 워크플로우를 다룹니다.

주제에서 직접 생성

felo-slides "Microservices vs monoliths: a pragmatic guide" --slides 12

마크다운 파일에서 생성

felo-slides --from ./meeting-notes.md --template "standup"

CLI는 마크다운을 파싱해 제목과 불릿 포인트를 자동으로 감지하고 슬라이드로 매핑합니다.

URL에서 생성

felo-slides --from-url https://github.com/org/repo/blob/main/README.md

문서, 블로그 글, RFC를 프레젠테이션으로 변환할 때 유용합니다.

배치 생성

# 여러 주제의 슬라이드를 한 번에 생성
felo-slides batch --file topics.txt --output ./deck-batch/

topics.txt 파일에는 줄마다 한 주제씩 작성:

Q4 OKR Review
New Hire Onboarding: Backend
Incident Postmortem: 2026-05-12 Outage
Architecture Decision Record: Event Sourcing

내보내기 형식

# PDF로 내보내기
felo-slides export ./output.felo --format pdf

# PPTX로 내보내기
felo-slides export ./output.felo --format pptx

# 이미지로 내보내기 (슬라이드당 하나의 PNG)
felo-slides export ./output.felo --format png --dpi 300

CI/CD 통합

# .github/workflows/weekly-deck.yml
name: Generate Weekly Update Deck
on:
  schedule:
    - cron: '0 9 * * 1'  # 매주 월요일 오전 9시

jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx felo-slides "Weekly engineering update for ${{ github.run_id }}" --template weekly --output ./decks/
      - uses: actions/upload-artifact@v4
        with:
          name: weekly-deck
          path: ./decks/

[IMG: GitHub Actions 실행 로그 — felo-slides 단계가 성공적으로 완료되고 생성된 덱이 Artifacts에 표시됨]

자동화 워크플로우 예시

다음은 Felo Slides가 시간을 절약해주는 실제 사례 세 가지입니다.

1. 회의 전 준비 봇

정기 회의 전 자동으로 시작 슬라이드를 생성하는 Slack 봇:

import { FeloSlides } from 'felo-slides';
import { getMeetingContext } from './calendar-integration';

const slides = new FeloSlides({ apiKey: process.env.FELO_SLIDES_API_KEY });

export async function prepareMeetingDeck(meetingId: string) {
  const context = await getMeetingContext(meetingId);

  const deck = await slides.generate({
    topic: context.title,
    slides: 8,
    context: [
      `Attendees: ${context.attendees.join(', ')}`,
      `Previous action items: ${context.lastActions.join('; ')}`,
      `Agenda: ${context.agenda.join(', ')}`,
    ],
    template: 'standup',
  });

  await slides.export(deck.id, { format: 'pdf' });
  await postToSlack(context.channel, {
    text: `📊 Starter deck for ${context.title}`,
    files: [{ file: deck.exportPath, filename: `${context.title}.pdf` }],
  });
}

2. 문서 → 프레젠테이션 파이프라인

새 RFC나 설계 문서를 자동으로 프레젠테이션 초안으로 변환:

#!/bin/bash
# hooks/post-commit-slides.sh

# /docs/rfcs 내 새 .md 파일 감지
CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD -- 'docs/rfcs/*.md')

for file in $CHANGED_FILES; do
  TITLE=$(head -1 "$file" | sed 's/^# //')
  OUTPUT="./presentations/$(basename "$file" .md).felo"

  npx felo-slides --from "$file" --template "rfc" --output "$OUTPUT"

  echo "Generated slides for: $TITLE → $OUTPUT"
done

이 스크립트를 Git 훅이나 CI 단계로 연결하면, 새로운 RFC가 추가될 때마다 자동으로 슬라이드 덱이 생성됩니다.

3. 다중 형식 콘텐츠 재활용

하나의 콘텐츠를 블로그 포스트, 슬라이드 덱, 소셜 스레드로 변환:

import { FeloSlides } from 'felo-slides';
import { generateBlog } from './blog-generator';
import { generateSocialThread } from './social-generator';

async function repurposeContent(sourceUrl: string) {
  // 원본 콘텐츠 가져오기 및 분석
  const content = await fetchAndParse(sourceUrl);

  // 세 가지 형식을 병렬로 생성
  const [blog, deck, thread] = await Promise.all([
    generateBlog(content, { words: 2000 }),
    new FeloSlides().generate({
      topic: content.title,
      slides: 10,
      context: content.summary,
    }),
    generateSocialThread(content, { posts: 8 }),
  ]);

  return { blog, deck, thread };
}

하나의 소스에서 세 가지 결과물. 슬라이드 덱은 보조물이 아닌, 블로그 포스트와 동일한 콘텐츠 인텔리전스로 생성됩니다.

[IMG: 콘텐츠 하나가 블로그 포스트, 슬라이드 덱, 소셜 스레드로 분기되는 흐름도]

API 참고서

맞춤형 통합을 구축하려는 팀을 위해 Felo Slides API는 세 가지 핵심 엔드포인트를 제공합니다.

인증

모든 요청은 헤더에 API 키가 필요합니다:

Authorization: Bearer fsk_your_api_key_here

POST /v1/slides/generate

새 프레젠테이션 생성.

curl -X POST https://api.slides.felo.ai/v1/slides/generate \
  -H "Authorization: Bearer fsk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Introduction to WebAssembly",
    "slideCount": 10,
    "template": "developer-dark",
    "context": [
      "Audience: senior backend engineers",
      "Focus on practical use cases, not theory",
      "Include performance comparison with Docker"
    ],
    "language": "en"
  }'

응답:

{
  "id": "deck_abc123",
  "status": "processing",
  "estimatedSeconds": 15,
  "slides": 10,
  "pollUrl": "/v1/slides/deck_abc123"
}

GET /v1/slides/{id}

생성 상태 확인 및 완성된 덱 가져오기.

curl https://api.slides.felo.ai/v1/slides/deck_abc123 \
  -H "Authorization: Bearer fsk_your_api_key_here"

완성 시 응답:

{
  "id": "deck_abc123",
  "status": "complete",
  "slides": [
    {
      "number": 1,
      "title": "What Is WebAssembly?",
      "content": "...",
      "notes": "..."
    }
  ],
  "downloadUrls": {
    "felo": "https://api.slides.felo.ai/v1/slides/deck_abc123/download?felo",
    "pdf": "https://api.slides.felo.ai/v1/slides/deck_abc123/download?pdf",
    "pptx": "https://api.slides.felo.ai/v1/slides/deck_abc123/download?pptx"
  }
}

POST /v1/slides/{id}/edit

기존 덱을 프로그램적으로 수정.

curl -X POST https://api.slides.felo.ai/v1/slides/deck_abc123/edit \
  -H "Authorization: Bearer fsk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "actions": [
      { "type": "update", "slide": 3, "title": "WASM vs Containers: Benchmarks" },
      { "type": "insert", "after": 5, "title": "Live Demo", "content": "..." },
      { "type": "delete", "slide": 8 }
    ]
  }'

속도 제한

무료 요금제: 하루 50회, 분당 5회
프로 요금제: 하루 500회, 분당 30회
엔터프라이즈: 맞춤 한도

felo-slides CLI 및 모든 SDK는 지수 백오프와 함께 속도 제한을 자동으로 처리합니다.

[IMG: 세 가지 엔드포인트 및 요청/응답 예시를 보여주는 API 문서 스크린샷]

FAQ

Felo Slides를 오프라인에서 사용할 수 있나요?

생성 단계는 서버 측 AI 모델 호출이 필요하므로 API 호출이 요구됩니다. 하지만 생성된 덱을 PDF나 PPTX로 내보내면 이후에는 로컬에서 작업할 수 있습니다. CLI는 마지막 10개 덱을 캐싱하여 오프라인에서도 열람이 가능합니다.

민감한 콘텐츠는 어떻게 처리되나요?

모든 API 요청은 전송 중(TLS 1.3)과 저장 시 암호화됩니다. 슬라이드 내용은 모델 학습에 사용되지 않습니다. 데이터 거주 요건이 있는 기업 고객은 온프레미스 배포 옵션을 문의하세요.

나만의 템플릿을 사용할 수 있나요?

네. npm 패키지와 API 모두 커스텀 템플릿을 지원합니다. JSON 파일로 템플릿을 정의하고(위 Claude Code 섹션 참고) 이름이나 경로로 지정하면 됩니다:

felo-slides "Topic here" --template ./my-template.json

출력 형식은 어떤가요?

생성된 덱은 .felo 파일(구조화된 JSON 형식)로 저장됩니다. PDF, PPTX, PNG, HTML로 내보낼 수 있습니다. .felo 형식은 수정 가능하여, 프로그래밍적으로 수정하거나 다시 AI 편집을 위해 불러올 수 있습니다.

Claude Code 스킬은 Claude CLI에서도 작동하나요, 아니면 데스크톱 앱 전용인가요?

둘 다 가능합니다. claude 터미널 버전과 Claude 데스크톱 앱 모두 동일한 설치 방식으로 작동합니다.

영어 외 다른 언어로도 슬라이드를 생성할 수 있나요?

가능합니다. API에 language 매개변수(ISO 639-1 코드)를 전달하거나 CLI에서 --lang 플래그를 사용하세요:

felo-slides "Kubernetes 入门指南" --lang zh
felo-slides "Introducción a WebAssembly" --lang es

AI는 기술 용어를 표준 형태로 유지하면서 지정한 언어로 내용을 생성합니다.

OpenClaw 스킬은 Claude Code 스킬과 어떻게 다른가요?

Claude Code 스킬은 에디터 내 상호작용용으로 최적화되어, 사용자와의 질의응답을 통해 반복적으로 작업합니다. OpenClaw 스킬은 자율 에이전트 워크플로우용으로, 구조화된 입력을 받아 결과만 반환합니다. 엔진은 같지만 상호작용 모델이 다릅니다.

시작하기

빠른 시작 체크리스트:

API 키 발급 → slides.felo.ai/settings/api
CLI 설치 → npm install -g felo-slides
키 설정 → export FELO_SLIDES_API_KEY=fsk_...
첫 덱 생성 → felo-slides "Your topic here"
Claude Code에 추가 → claude skill add felo-slides
자동화 구성 → API를 워크플로우에 연결

Felo Slides는 디자인 툴을 대체하려는 것이 아닙니다. “급하게 슬라이드 만들어야 해” 문제를 없애려는 것입니다 — 특히 터미널, 에디터, 또는 에이전트 워크플로 안에서 일하고 있을 때 말이죠.

AI가 이렇게 생성한 슬라이드는 완벽한 초안은 아닙니다. 유용한 초안입니다. 10분 정도만 수정하면 바로 쓸 수 있는 그런 초안 말이죠. 그게 바로 기준입니다.

시도해 보세요:

npx felo-slides "The talk I've been meaning to give"

→ Felo Slides · npm 패키지 · API 문서 · GitHub

이 글은 다음 언어로도 읽을 수 있습니다: English, 简体中文, 日本語, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা, Português.

Felo Slides란? (개발자를 위한 설명)​

설치 및 설정​

사전 요구 사항​

npm 패키지 설치​

인증 설정​

작동 확인​

Claude Code와 함께 Felo Slides 사용하기​

Claude Code Skill 설치​

Claude Code에서 기본 사용법​

고급: Claude Code에서 사용자 정의 템플릿 사용​

대화형 슬라이드 편집​

OpenClaw와 함께 Felo Slides 사용하기​

설정​

에이전트 기반 슬라이드 생성​

명령줄 예시​

주제에서 직접 생성​

마크다운 파일에서 생성​

URL에서 생성​

배치 생성​

내보내기 형식​

CI/CD 통합​

자동화 워크플로우 예시​

1. 회의 전 준비 봇​

2. 문서 → 프레젠테이션 파이프라인​

3. 다중 형식 콘텐츠 재활용​

API 참고서​

인증​

POST /v1/slides/generate​

GET /v1/slides/{id}​

POST /v1/slides/{id}/edit​

속도 제한​

FAQ​

Felo Slides를 오프라인에서 사용할 수 있나요?​

민감한 콘텐츠는 어떻게 처리되나요?​

나만의 템플릿을 사용할 수 있나요?​

출력 형식은 어떤가요?​

Claude Code 스킬은 Claude CLI에서도 작동하나요, 아니면 데스크톱 앱 전용인가요?​

영어 외 다른 언어로도 슬라이드를 생성할 수 있나요?​

OpenClaw 스킬은 Claude Code 스킬과 어떻게 다른가요?​

시작하기​