Felo Slides'i Claude Code ve AI Ajanları ile Kullanma Rehberi

Felo Slides’i Claude Code, OpenClaw ve felo-slides npm paketiyle terminalden AI destekli slaytlar oluşturun. Programatik sunum üretimi için geliştirici rehberi.

$ npx felo-slides "Kubernetes pod zamanlamasını 8 slaytta açıkla"
✓ Konu analiz ediliyor...
✓ Taslak oluşturuluyor (8 slayt)...
✓ Slayt içeriği oluşturuluyor...
✓ Sunum hazırlanıyor...
✔ Tamamlandı → kubernetes-pod-scheduling.felo

Hepsi bu kadar. Tarayıcı yok. Sürükle-bırak yok. Şablon seçici yok. Sadece bir komut yazdınız ve sekiz slayt ortaya çıktı.

Eğer 40 dakikalık ama bir sunumla halledilebilecek bir toplantıya katıldıysanız zaten Felo Slides’ı neden yaptığımızı biliyorsunuzdur. Ama bu yazı web uygulamasıyla ilgili değil — geliştiricilere bir API verdiğinizde ve “her şeyi otomatikleştirin” dediğinizde neler olduğunu anlatıyor.

İşte, terminalden çıkmadan Claude Code, OpenClaw ajanları ve kendi betiklerinizle Felo Slides kullanarak AI destekli slaytlar oluşturmanın yolu.

[IMG: Tek bir komuttan sunum üreten felo-slides CLI'ını gösteren terminal ekran görüntüsü, çıktı dosyası vurgulanmış şekilde]

Felo Slides Nedir (Geliştiriciler İçin)?

Felo Slides bir AI sunum motorudur. Çoğu kişi onu slides.felo.ai adresindeki web uygulaması olarak tanır. Ama perde arkasında şu bileşenler de vardır:

• felo-slides npm paketi — programatik olarak slayt üretimi için CLI ve kütüphane
• Claude Code Yeteneği — Claude Code’un doğrudan sunumlar oluşturmasını sağlayan yerel yetenek
• OpenClaw Yeteneği — aynı fikir, OpenClaw ajan framework’üne entegre edilmiş
• REST API — slayt oluşturma, konu analizi ve şablon işleme için HTTP uç noktaları

Web uygulaması cilalı bir ön yüzdür. Geliştirici araçları motor kısmıdır. Bunları karıştırıp kullanabilirsiniz: hızlı yerel üretim için CLI, sunucu tarafı otomasyon için API, veya etkileşimli üretim için Claude Code yeteneğini.

Ne zaman hangisini kullanmalı:

Kullanım Durumu	Araç
Terminalden hızlı slayt üretimi	felo-slides CLI
Editör içinde etkileşimli üretim	Claude Code Yeteneği
Ajan tabanlı iş akışları	OpenClaw Yeteneği
Arka plan işlemleri / CI / toplu işler	Felo Slides API’si

Kurulum ve Başlangıç

Gerekli Önkoşullar

• Node.js 18+ (20+ önerilir)
• API erişimi olan bir Felo hesabı (ücretsiz katman yeterli)
• slides.felo.ai/settings/api adresinden alınmış bir API anahtarı

npm Paketini Kurun

npm install -g felo-slides

Ya da yüklemeden kullanın:

npx felo-slides "Buraya sunum konunuzu yazın"

Kimlik Doğrulama

API anahtarınızı ortam değişkeni olarak ayarlayın:

export FELO_SLIDES_API_KEY=fsk_api_anahtariniz

Veya proje kökünüzde .felo-slides.json oluşturun:

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

Çalıştığını Doğrulayın

$ felo-slides --version
felo-slides 2.4.0

$ felo-slides --check
✓ API anahtarı geçerli
✓ Kota: 47/50 istek kaldı
✓ Yüklenen şablon: 12

[IMG: Başarılı kurulum ve kimlik doğrulama hatalarını yan yana gösteren terminal çıktısı karşılaştırması]

Felo Slides’i Claude Code ile Kullanma

Burada işler ilginçleşiyor. Claude Code Yeteneği, Claude’un editörünü bir slayt fabrikasına dönüştürür. Komut yazıp çıktıyı kopyalamak yerine, Claude sunumları doğrudan oluşturur, düzenler ve dışa aktarır.

Claude Code Yeteneğini Kurun

# Claude Code proje dizininizde
claude skill add felo-slides

Bu işlem Felo Slides yeteneğini Claude Code’a kaydeder. Artık Claude sunum oluşturabileceğini bilir ve felo-slides API’nin tüm yüzeyine erişimi vardır.

Claude Code’da Temel Kullanım

Kurulumdan sonra doğal bir şekilde Claude’a isteğinizi yazın:

> Q3 mühendislik yol haritamız hakkında 10 slaytlık bir sunum oluştur.
  Şu bölümleri dahil et: platform geçişi, işe alım planı
  ve altyapı bütçesi.

Claude şunları yapacaktır:

1. Taslağı oluşturur ve sizinle yapıyı onaylar
2. Felo Slides API’sini kullanarak içerik üretir
3. .felo dosyasını proje dizinine kaydeder
4. Belirli slaytlarda yineleme teklif eder

Kontekst değişimi yok. Kopyala-yapıştır yok. Slaytlar kodunuzla birlikte aynı depoda yaşar.

İleri Seviye: Claude Code’da Özel Şablonlar

Proje bazlı özel slayt şablonları tanımlayabilirsiniz; Claude bunları otomatik kullanır:

mkdir -p .felo/templates

.felo/templates/engineering.json oluşturun:

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

Sonra Claude Code’da:

> Kimlik doğrulama servisi geçişi hakkında bir sunum hazırla.
  Mühendislik şablonunu kullan.

Claude şablonu otomatik algılar ve tüm oluşturulan slaytlara uygular.

[IMG: Claude Code editöründe kullanıcı ve Claude arasındaki konuşmayı, oluşturulan .felo dosyasını dosya ağacında gösteren ekran görüntüsü]

Slaytları Etkileşimli Düzenleme

Claude Code entegrasyonunun gerçek gücü yineli düzenlemededir:

> 3. slayt fazla yoğun. İkiye böl.
  Mimari diyagramı 4. slayta taşı.

> 5-7. slaytlara konuşmacı notları ekle.
  Her biri 50 kelimeyi geçmesin.

> Vurgu rengini markamızın yeşiline (#10b981) değiştir
  ve logomuzu başlık slaydına ekle.

Her düzenleme bir API çağrısıdır ama siz HTTP isteğini hiç görmezsiniz. Claude tüm işlerliği yönetir.

Felo Slides’i OpenClaw ile Kullanma

OpenClaw, ajan yaklaşımını bir adım öteye taşır. Felo Slides OpenClaw Yeteneği, AI ajanlarının slayt üretimini daha büyük iş akışlarının parçası haline getirmesini sağlar — sadece doğrudan komutlara yanıt olarak değil.

Kurulum

openclaw skill install felo-slides

OpenClaw çalışma alanınızda yapılandırın:

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

Ajan Tabanlı Slayt Üretimi

OpenClaw ile slayt üretimini ajan iş akışlarından tetikleyebilirsiniz:

Kullanıcı: Acme anlaşmasını yeni kapattık. 
           Mühendislik ekibi için açılış sunumu hazırla.
           Notion’daki proje özetini ve Linear’daki zaman çizelgesini kullan.

Ajan: [Notion özetini okur]
      [Linear zaman çizelgesini çeker]
      [felo-slides üzerinden 12 slaytlık açılış sunumu oluşturur]
      [output/slides/acme-kickoff.felo olarak kaydeder]
      "Tamamlandı. Kapsam, zaman çizelgesi, ekip görevleri 
       ve kilometre taşlarını içeren 12 slaytlık sunum oluşturuldu. 
       #eng-general kanalına göndereyim mi?"

Ajan iki dış araçtan bağlam topladı, bunu bir sunuma dönüştürdü ve tüm slaytları tek hamlede oluşturdu.

[IMG: OpenClaw ajan iş akışı diyagramı: kullanıcı isteği → bağlam toplama (Notion, Linear) → felo-slides API → çıktı dosyası → teslim]

Komut Satırı Örnekleri

Şimdi CLI’a biraz daha yakından bakalım. Bu örnekler en yaygın geliştirici iş akışlarını kapsar.

Konudan Slayt Üretmek

felo-slides "Mikroservisler vs monolitler: pragmatik bir rehber" --slides 12

Markdown Dosyasından Üretmek

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

CLI markdown dosyanızı ayrıştırır, başlıkları ve madde işaretlerini algılar, bunları otomatik olarak slaytlara dönüştürür.

URL’den Üretmek

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

Dökümantasyon, blog yazıları veya RFC’leri sunuma dönüştürmek için idealdir.

Toplu Üretim

# Birden fazla konu için slayt üret
felo-slides batch --file topics.txt --output ./deck-batch/

topics.txt dosyası şöyle görünür:

Q4 OKR Değerlendirmesi
Yeni Katılım: Backend
Vaka Geçmiş Raporu: 2026-05-12 Kesintisi
Mimari Karar Kaydı: Olay Kaynaklama

Dışa Aktarma Formatları

# PDF olarak dışa aktar
felo-slides export ./output.felo --format pdf

# PPTX olarak dışa aktar
felo-slides export ./output.felo --format pptx

# Görseller olarak dışa aktar (her slayt için bir PNG)
felo-slides export ./output.felo --format png --dpi 300

CI/CD Entegrasyonu

# .github/workflows/weekly-deck.yml
name: Haftalık Güncelleme Sunumu Oluştur
on:
  schedule:
    - cron: '0 9 * * 1'  # Her Pazartesi 09:00

jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx felo-slides "Haftalık mühendislik güncellemesi ${{ github.run_id }}" --template weekly --output ./decks/
      - uses: actions/upload-artifact@v4
        with:
          name: weekly-deck
          path: ./decks/

[IMG: GitHub Actions çalıştırma günlüğü, felo-slides adımının başarıyla tamamlandığını ve oluşturulan sunumun Artifacts altında listelendiğini gösteriyor]

Otomasyon İş Akışı Örnekleri

İşte Felo Slides’in ciddi zaman tasarrufu sağladığı üç gerçek iş akışı.

1. Toplantı Öncesi Hazırlık Botu

Her yinelenen toplantı öncesinde başlangıç sunumu hazırlayan bir Slack botu:

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: [
      `Katılımcılar: ${context.attendees.join(', ')}`,
      `Önceki eylemler: ${context.lastActions.join('; ')}`,
      `Gündem: ${context.agenda.join(', ')}`,
    ],
    template: 'standup',
  });

  await slides.export(deck.id, { format: 'pdf' });
  await postToSlack(context.channel, {
    text: `📊 ${context.title} için başlangıç sunumu`,
    files: [{ file: deck.exportPath, filename: `${context.title}.pdf` }],
  });
}

2. Belgelerden → Sunuma Otomatik Dönüştürme

Yeni RFC veya tasarım dokümanlarını otomatik olarak sunum taslağına dönüştürün:

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

# /docs/rfcs içindeki yeni .md dosyalarını tespit et
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 "Slaytlar oluşturuldu: $TITLE → $OUTPUT"
done

Bunu bir git kancası veya CI adımı olarak bağlayın, her yeni RFC otomatik olarak bir sunumla eşleştirilsin.

3. Çok Formatlı İçerik Dönüştürme

Tek bir içeriği blog yazısı, slayt ve sosyal medya zinciri haline getirin:

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

async function repurposeContent(sourceUrl: string) {
  // Kaynağı getir ve analiz et
  const content = await fetchAndParse(sourceUrl);

  // Üç formatı paralel olarak üret
  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 };
}

Tek kaynak, üç çıktı. Slayt sunumu sonradan düşünülmüş bir şey değil — blog yazısı kadar akıllı içerikle üretilir.

[IMG: Tek kaynak içeriğin üç çıktıya dallandığı akış diyagramı: blog yazısı, slayt sunumu ve sosyal medya zinciri]

API Referansı

Özel entegrasyonlar geliştiren ekipler için Felo Slides API üç temel uç nokta sunar.

Kimlik Doğrulama

Tüm isteklerde header’da API anahtarı gerekir:

Authorization: Bearer fsk_api_anahtariniz

POST /v1/slides/generate

Yeni bir sunum oluşturur.

curl -X POST https://api.slides.felo.ai/v1/slides/generate \
  -H "Authorization: Bearer fsk_api_anahtariniz" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "WebAssembly'ye Giriş",
    "slideCount": 10,
    "template": "developer-dark",
    "context": [
      "Hedef kitle: kıdemli backend mühendisleri",
      "Teori değil, pratik kullanım örneklerine odaklan",
      "Docker ile performans karşılaştırmasını ekle"
    ],
    "language": "tr"
  }'

Yanıt:

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

GET /v1/slides/{id}

Durumu kontrol eder ve tamamlanmış sunumu getirir.

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

Tamamlandığında yanıt:

{
  "id": "deck_abc123",
  "status": "complete",
  "slides": [
    {
      "number": 1,
      "title": "WebAssembly Nedir?",
      "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

Var olan bir sunumu programatik olarak düzenler.

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

Kota Sınırları

• Ücretsiz: günde 50 istek, dakikada 5 istek
• Pro: günde 500 istek, dakikada 30 istek
• Kurumsal: özel sınırlar

felo-slides CLI ve tüm SDK’lar, üstel geri çekilme ile otomatik kota yönetimi uygular.

[IMG: Üç uç noktanın istek/yanıt örneklerini gösteren API dokümantasyonu ekran görüntüsü]

SSS

Felo Slides’i çevrimdışı kullanabilir miyim?

Sunum oluşturma işlemi bir API çağrısı gerektirir (AI modeli sunucu tarafında çalışır). Ancak oluşturduktan sonra PDF veya PPTX olarak dışa aktarabilir ve yerel olarak çalışabilirsiniz. CLI, son 10 sunumunuzu çevrimdışı görüntüleme için önbelleğe alır.

Hassas içeriği nasıl işlerim?

Tüm API istekleri aktarımda (TLS 1.3) ve depoda şifrelenir. Slayt içerikleri model eğitimi için kullanılmaz. Veri yerelliği gereksinimi olan kurumsal dağıtımlar için, kurum içi seçenekler hakkında bizimle iletişime geçin.

Kendi şablonlarımı kullanabilir miyim?

Evet. npm paketi ve API özel şablonları destekler. Şablonunuzu JSON dosyası olarak tanımlayın (yukarıdaki Claude Code bölümüne bakın) ve ad veya yol ile referans verin:

felo-slides "Konu buraya" --template ./my-template.json

Çıktı formatı nedir?

Oluşturulan sunumlar .felo dosyası olarak kaydedilir (yapılandırılmış bir JSON formatı). PDF, PPTX, PNG veya HTML’e dışa aktarabilirsiniz. .felo formatı düzenlenebilir — programatik değişiklik yapabilir veya AI ile yeniden içe aktarabilirsiniz.

Claude Code yeteneği sadece masaüstü uygulamada mı çalışıyor?

Hayır. Terminaldeki claude komutuyla ve Claude masaüstü uygulamasıyla çalışır. Kurulum her iki durumda da aynıdır.

İngilizce dışındaki dillerde slayt üretebilir miyim?

Evet. API’de language parametresini (ISO 639-1 kodu) veya CLI’da --lang bayrağını kullanın:

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

AI belirttiğiniz dilde içerik üretirken teknik terimleri standart biçimde korur.

OpenClaw yeteneği Claude Code yeteneğinden nasıl farklı?

Claude Code yeteneği etkileşimli editör içi kullanım için optimize edilmiştir — açıklayıcı sorular sorar ve yinelemeli çalışır. OpenClaw yeteneği ise otonom ajan iş akışları için tasarlanmıştır — yapılandırılmış girdi alır ve çıktı döndürür. Motor aynı, etkileşim modeli farklıdır.

Başlarken

İşte hızlı başlangıç kontrol listesi:

1. API anahtarınızı alın → slides.felo.ai/settings/api
2. CLI’ı kurun → npm install -g felo-slides
3. Anahtarınızı ayarlayın → export FELO_SLIDES_API_KEY=fsk_...
4. İlk sunumunuzu oluşturun → felo-slides "Buraya konunuzu yazın"
5. Claude Code’a ekleyin → claude skill add felo-slides
6. Otomatize edin → API’yı iş akışlarınıza bağlayın

Felo Slides, tasarım aracınızı değiştirmeye çalışmıyor. “Hızlıca bir sunum lazım” sorununu ortadan kaldırmayı amaçlıyor — özellikle terminalde, editörünüzde veya bir ajan iş akışında çalışırken.

Bu şekilde üretilen AI slaytları mükemmel ilk taslaklar değildir. Kullanışlı ilk taslaklardır. O türden ki açar, 10 dakika düzeltir ve gönderirsiniz. Bizim hedefimiz bu.

Deneyin:

npx felo-slides "Bir türlü fırsat bulamadığım konuşma"

→ Felo Slides · npm paketi · API dokümantasyonu · GitHub

---

Bu yazı şu dillerde de mevcut: English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Italiano, ไทย, Español, বাংলা and Português.