@boostecom/provider 0.0.1

package/docs/content/installation.mdx

@@ -0,0 +1,246 @@
+---
+title: Installation
+description: Guide d'installation et de configuration du provider Claude Code
+---
+
+# Installation
+
+Ce guide vous accompagne dans l'installation et la configuration du provider Claude Code pour le Vercel AI SDK. Ce provider fonctionne via le CLI Claude Code et votre abonnement Pro/Max — aucune clé API n'est nécessaire.
+
+## Prérequis
+
+- **Node.js** ≥ 18
+- **Abonnement Claude Pro ou Max** (pas de clé API Anthropic nécessaire)
+- Terminal avec pnpm ou votre gestionnaire de packages préféré
+
+## Étape 1 : Installer le CLI Claude Code
+
+Le CLI Claude Code est requis pour communiquer avec les serveurs d'Anthropic.
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+<Note type="info">
+  Le CLI doit être installé globalement (`-g`) pour être accessible depuis n'importe où sur votre système.
+</Note>
+
+## Étape 2 : Authentification
+
+Connectez-vous avec votre compte Claude (abonnement Pro ou Max) :
+
+```bash
+claude login
+```
+
+Cette commande ouvrira votre navigateur et vous guidera à travers le processus d'authentification. Vos identifiants seront stockés de manière sécurisée dans `~/.claude/`.
+
+<Accordion title="Vérifier l'authentification">
+  Pour vérifier que l'authentification a réussi, exécutez :
+  
+  ```bash
+  claude --version
+  ```
+  
+  Si vous voyez la version sans erreur, vous êtes correctement authentifié.
+</Accordion>
+
+## Étape 3 : Installer le provider
+
+### Pour AI SDK v6 (Recommandé)
+
+```bash
+npm install @boostecom/provider ai@^6.0.0 zod@^4.0.0
+```
+
+### Pour AI SDK v5
+
+```bash
+npm install @boostecom/provider@ai-sdk-v5 ai@^5.0.0 zod@^4.0.0
+```
+
+### Pour AI SDK v4 (Legacy)
+
+```bash
+npm install @boostecom/provider@ai-sdk-v4 ai@^4.3.16 zod@^3.0.0
+```
+
+<Note type="warning">
+  **Compatibilité Zod** : Versions 3.2.0+ nécessitent Zod 4. Si vous devez utiliser Zod 3, installez `@boostecom/provider@3.1.x`.
+</Note>
+
+## Étape 4 : Vérification de l'installation
+
+Créez un fichier de test pour vérifier que tout fonctionne :
+
+```typescript title="test.ts"
+import { generateText } from 'ai';
+import { claudeCode } from '@boostecom/provider';
+
+async function test() {
+  try {
+    const { text } = await generateText({
+      model: claudeCode('haiku'),
+      prompt: 'Dis bonjour en une phrase',
+    });
+    
+    console.log('✅ Installation réussie!');
+    console.log('Réponse:', text);
+  } catch (error) {
+    console.error('❌ Erreur:', error);
+  }
+}
+
+test();
+```
+
+Exécutez le test :
+
+```bash
+npx tsx test.ts
+```
+
+Si vous voyez une réponse de Claude, félicitations ! Votre installation est complète.
+
+## Configuration avancée
+
+### Variables d'environnement
+
+Vous pouvez configurer certains comportements via des variables d'environnement :
+
+```bash
+# Chemin personnalisé vers le CLI Claude Code
+export CLAUDE_CODE_PATH="/chemin/vers/claude"
+
+# Répertoire de travail par défaut
+export CLAUDE_CWD="/chemin/projet"
+```
+
+### Utilisation dans un monorepo
+
+Si vous utilisez un monorepo (pnpm, yarn workspaces, etc.), installez le CLI globalement et le provider localement dans chaque package :
+
+```bash
+# Global
+npm install -g @anthropic-ai/claude-code
+
+# Dans chaque package
+cd packages/mon-app
+npm install @boostecom/provider ai zod
+```
+
+### Installation dans Docker
+
+Pour utiliser le provider dans un conteneur Docker :
+
+```dockerfile
+FROM node:18-alpine
+
+# Installer le CLI globalement
+RUN npm install -g @anthropic-ai/claude-code
+
+# Copier les identifiants d'authentification (NE PAS faire en production)
+# Préférez utiliser des secrets ou variables d'environnement
+COPY .claude /root/.claude
+
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+
+COPY . .
+CMD ["node", "index.js"]
+```
+
+<Note type="danger">
+  **Sécurité** : Ne copiez JAMAIS vos identifiants dans une image Docker de production. Utilisez des secrets Docker, des volumes montés ou des services de gestion de secrets.
+</Note>
+
+### Installation dans un environnement CI/CD
+
+Pour les environnements CI/CD (GitHub Actions, GitLab CI, etc.) :
+
+```yaml title=".github/workflows/test.yml"
+name: Test Claude Integration
+
+on: [push]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v3
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+      
+      - name: Install CLI
+        run: npm install -g @anthropic-ai/claude-code
+      
+      - name: Setup Authentication
+        run: |
+          mkdir -p ~/.claude
+          echo "${{ secrets.CLAUDE_AUTH }}" > ~/.claude/auth.json
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run tests
+        run: npm test
+```
+
+<Note type="info">
+  Stockez vos identifiants Claude dans les secrets de votre plateforme CI/CD pour une sécurité maximale.
+</Note>
+
+## Dépannage
+
+### Le CLI n'est pas trouvé
+
+**Problème** : `command not found: claude`
+
+**Solution** :
+```bash
+# Vérifier l'installation
+npm list -g @anthropic-ai/claude-code
+
+# Réinstaller si nécessaire
+npm uninstall -g @anthropic-ai/claude-code
+npm install -g @anthropic-ai/claude-code
+```
+
+### Erreur d'authentification
+
+**Problème** : `Authentication failed` ou `Unauthorized`
+
+**Solution** :
+```bash
+# Supprimer les identifiants existants
+rm -rf ~/.claude
+
+# Se reconnecter
+claude login
+```
+
+### Incompatibilité de version
+
+**Problème** : Erreurs de types TypeScript ou comportements inattendus
+
+**Solution** :
+```bash
+# Vérifier les versions
+npm list ai @boostecom/provider zod
+
+# Réinstaller avec les bonnes versions
+npm install @boostecom/provider@latest ai@^6.0.0 zod@^4.0.0
+```
+
+## Prochaines étapes
+
+Maintenant que l'installation est complète, consultez :
+
+- [Guide d'utilisation](/docs/guide) pour les patterns de base
+- [API Reference](/docs/api) pour la documentation complète
+- [Exemples](/docs/examples) pour des cas d'usage pratiques