f-is-h · mtreize · Mar 24, 2026
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # Usage4Claude
 
-[English](README.md) | [日本語](docs/README.ja.md) | [简体中文](docs/README.zh-CN.md) | [繁體中文](docs/README.zh-TW.md) | [한국어](docs/README.ko.md)
+[English](README.md) | [日本語](docs/README.ja.md) | [简体中文](docs/README.zh-CN.md) | [繁體中文](docs/README.zh-TW.md) | [한국어](docs/README.ko.md) | [Français](docs/README.fr.md)
 
 <div align="center">
 
@@ -66,6 +66,7 @@ All platforms share the same usage quota, monitored in one place!
   - 简体中文
   - 繁体中文
   - 한국어
+  - Français
   - More languages coming soon...
 
 ### 🔧 Convenient Features

diff --git a/Usage4Claude/Helpers/LocalizationHelper.swift b/Usage4Claude/Helpers/LocalizationHelper.swift
@@ -238,6 +238,7 @@ enum L {
         static var chinese: String { localized("language.chinese") }
         static var chineseTraditional: String { localized("language.chinese_traditional") }
         static var korean: String { localized("language.korean") }
+        static var french: String { localized("language.french") }
     }
 
     // MARK: - Window Titles

diff --git a/Usage4Claude/Models/UserSettings.swift b/Usage4Claude/Models/UserSettings.swift
@@ -269,6 +269,8 @@ enum AppLanguage: String, CaseIterable, Codable {
     case chineseTraditional = "zh-Hant"
     /// 韩语
     case korean = "ko"
+    /// 法语
+    case french = "fr"
 
     var localizedName: String {
         switch self {
@@ -282,6 +284,8 @@ enum AppLanguage: String, CaseIterable, Codable {
             return L.Language.chineseTraditional
         case .korean:
             return L.Language.korean
+        case .french:
+            return L.Language.french
         }
     }
 }
@@ -300,6 +304,8 @@ extension AppLanguage {
             return Locale(identifier: "zh_TW")
         case .korean:
             return Locale(identifier: "ko_KR")
+        case .french:
+            return Locale(identifier: "fr_FR")
         }
     }
 }

diff --git a/Usage4Claude/Resources/en.lproj/Localizable.strings b/Usage4Claude/Resources/en.lproj/Localizable.strings
@@ -150,6 +150,7 @@
 "language.chinese" = "中文（简体）";
 "language.chinese_traditional" = "中文（繁體）";
 "language.korean" = "한국어";
+"language.french" = "Français";
 
 // MARK: - Window Titles
 "window.settings_title" = "Usage4Claude Settings";

diff --git a/Usage4Claude/Resources/fr.lproj/Localizable.strings b/Usage4Claude/Resources/fr.lproj/Localizable.strings
diff --git a/Usage4Claude/Resources/ja.lproj/Localizable.strings b/Usage4Claude/Resources/ja.lproj/Localizable.strings
@@ -150,6 +150,7 @@
 "language.chinese" = "中文（簡体字）";
 "language.chinese_traditional" = "中文（繁體字）";
 "language.korean" = "한국어";
+"language.french" = "Français";
 
 // MARK: - Window Titles
 "window.settings_title" = "Usage4Claude 設定";

diff --git a/Usage4Claude/Resources/ko.lproj/Localizable.strings b/Usage4Claude/Resources/ko.lproj/Localizable.strings
@@ -150,6 +150,7 @@
 "language.chinese" = "中文（简体）";
 "language.chinese_traditional" = "中文（繁体）";
 "language.korean" = "한국어";
+"language.french" = "Français";
 
 // MARK: - Window Titles
 "window.settings_title" = "Usage4Claude 설정";

diff --git a/Usage4Claude/Resources/zh-Hans.lproj/Localizable.strings b/Usage4Claude/Resources/zh-Hans.lproj/Localizable.strings
@@ -150,6 +150,7 @@
 "language.chinese" = "中文（简体）";
 "language.chinese_traditional" = "中文（繁体）";
 "language.korean" = "한국어";
+"language.french" = "Français";
 
 // MARK: - Window Titles
 "window.settings_title" = "Usage4Claude 设置";

diff --git a/Usage4Claude/Resources/zh-Hant.lproj/Localizable.strings b/Usage4Claude/Resources/zh-Hant.lproj/Localizable.strings
@@ -150,6 +150,7 @@
 "language.english" = "English";
 "language.japanese" = "日本語";
 "language.korean" = "한국어";
+"language.french" = "Français";
 
 // MARK: - Window Titles
 "window.settings_title" = "Usage4Claude 設定";

diff --git a/Usage4Claude/Views/Settings/Welcome/WelcomeView.swift b/Usage4Claude/Views/Settings/Welcome/WelcomeView.swift
@@ -617,6 +617,10 @@ struct SetupStepView: View {
         case .korean:
             let anchor = section == .initialSetup ? "#초기-설정" : "#-자주-묻는-질문"
             return "\(baseURL)/docs/README.ko.md\(anchor)"
+
+        case .french:
+            let anchor = section == .initialSetup ? "#configuration-initiale" : "#-faq"
+            return "\(baseURL)/docs/README.fr.md\(anchor)"
         }
     }
 }

diff --git a/docs/README.fr.md b/docs/README.fr.md
@@ -0,0 +1,265 @@
+# Usage4Claude
+
+[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Français](README.fr.md)
+
+<div align="center">
+
+<img src="images/icon@2x.png" width="256" alt="icon">
+
+[![macOS](https://img.shields.io/badge/macOS-13.0%2B-blue?style=flat-square)](https://www.apple.com/macos/)
+[![Swift](https://img.shields.io/badge/Swift-5.0%2B-orange?style=flat-square)](https://swift.org)
+[![SwiftUI](https://img.shields.io/badge/SwiftUI-✓-green?style=flat-square)](https://developer.apple.com/xcode/swiftui/)
+[![License](https://img.shields.io/badge/License-MIT-purple?style=flat-square)](../LICENSE)
+[![Release](https://img.shields.io/github/v/release/f-is-h/Usage4Claude?style=flat-square)](https://github.com/f-is-h/Usage4Claude/releases)
+[![Downloads (all assets, all releases)](https://img.shields.io/github/downloads/f-is-h/Usage4Claude/total)](https://github.com/f-is-h/Usage4Claude/releases)
+
+**Une application macOS elegante dans la barre des menus pour surveiller en temps reel votre utilisation de Claude AI.**
+
+✨ **Surveille toutes les plateformes Claude : Web • Claude Code • Desktop • App Mobile • Cowork** ✨
+
+[Fonctionnalites](#-fonctionnalites) • [Installation](#-installation) • [Guide d'utilisation](#-guide-dutilisation) • [FAQ](#-faq) • [Support](#-support)
+
+</div>
+
+---
+
+## ✨ Fonctionnalites
+
+### 🎯 Fonctionnalites principales
+
+- **📊 Surveillance en temps reel** - Affiche le quota d'utilisation de l'abonnement Claude (Free/Pro/Team/Max) dans la barre des menus
+- **🎯 Support multi-limites** - Affiche jusqu'a 5 limites simultanement (5h/7j/Extra/7j Opus/7j Sonnet)
+- **🎨 Mode d'affichage intelligent** - Detection et affichage automatiques de tous les types de limites avec donnees disponibles
+- **⚙️ Affichage personnalise** - Selection manuelle des types de limites a afficher, toute combinaison possible
+- **🎨 Couleurs intelligentes** - Changement automatique des couleurs selon l'utilisation, chaque type de limite a son propre schema
+- **🔔 Notifications d'utilisation** - Avertissement a 90 % d'utilisation, notification lors de la reinitialisation du quota
+- **👥 Gestion multi-comptes** - Support de plusieurs comptes / plusieurs organisations par compte, changement rapide
+- **🌐 Connexion via navigateur integre** - Navigateur integre pour extraire automatiquement la Session Key, sans copie manuelle
+- **🎨 Reglages d'apparence** - Support du mode systeme / clair / sombre
+- **🕐 Format horaire** - Support du format systeme / 12h / 24h
+- **⏰ Minuterie precise** - Heure de reinitialisation du quota affichee a la minute pres
+- **🔄 Actualisation intelligente** - Rafraichissement adaptatif intelligent a 4 niveaux ou intervalles fixes (1/3/5/10 min)
+- **⚡ Actualisation manuelle** - Cliquez sur le bouton d'actualisation pour mettre a jour instantanement (protection anti-rebond de 10 s)
+- **💻 Experience native** - Application macOS 100 % native, legere et elegante
+
+### 🌐 Support multiplateforme
+
+Fonctionne avec tous les produits Claude :
+- 🌐 **Claude.ai** (Interface web)
+- 💻 **Claude Code** (Outil CLI pour developpeurs)
+- 🖥️ **Application de bureau** (macOS/Windows)
+- 📱 **Application mobile** (iOS/Android)
+- 🤝 **Cowork** (Agent IA)
+
+Toutes les plateformes partagent le meme quota d'utilisation, surveille en un seul endroit !
+
+### 🎨 Personnalisation
+
+- **🕓 Modes d'affichage multiples**
+  - Pourcentage uniquement - Epure et intuitif, visible en un coup d'oeil
+  - Icone uniquement - Discret et elegant, details au clic
+  - Icone + Pourcentage - Information complete, identification visuelle rapide
+
+- **🌍 Support multilingue**
+  - English
+  - 日本語
+  - 简体中文
+  - 繁体中文
+  - 한국어
+  - Francais
+  - D'autres langues a venir...
+
+### 🔒 Securite et confidentialite
+
+- 🏠 **Stockage local uniquement** - Toutes les donnees sont stockees localement, aucune collecte ni envoi d'informations personnelles
+- 🔐 **Protection Keychain** - Informations sensibles securisees dans le trousseau, pas de cles en clair
+- 📖 **Open source transparent** - Code entierement public, auditable par tous
+- 🛡️ **Protection Sandbox** - App Sandbox activee pour une securite renforcee
+
+---
+
+## 💾 Installation
+
+### Option 1 : Telecharger le binaire (recommande)
+
+1. Rendez-vous sur la [page des Releases](https://github.com/f-is-h/Usage4Claude/releases)
+2. Telechargez le dernier fichier `.dmg`
+3. Double-cliquez pour ouvrir, glissez l'application dans le dossier Applications
+4. Faites un clic droit sur l'app et selectionnez « Ouvrir » au premier lancement (autoriser l'app non signee)
+5. Autorisez l'acces au trousseau pour les informations d'authentification
+
+### Option 2 : Compiler depuis les sources
+
+#### Prerequis
+- macOS 13.0 ou ulterieur
+- Xcode 15.0 ou ulterieur
+- Git
+
+#### Etapes de compilation
+
+```bash
+# Cloner le depot
+git clone https://github.com/f-is-h/Usage4Claude.git
+cd Usage4Claude
+
+# Ouvrir dans Xcode
+open Usage4Claude.xcodeproj
+
+# Appuyez sur Cmd + R pour lancer dans Xcode
+```
+
+---
+
+## 📖 Guide d'utilisation
+
+### Configuration initiale
+
+1. **Lancer l'application**
+   L'ecran de bienvenue apparait au premier lancement
+
+2. **Configurer l'authentification**
+   - **Option 1 : Connexion via le navigateur (recommande)**
+     - Cliquez sur le bouton « Connexion via le navigateur »
+     - Connectez-vous a votre compte Claude dans le navigateur integre
+     - La Session Key sera extraite automatiquement apres la connexion
+   - **Option 2 : Saisie manuelle**
+     - Ouvrez votre navigateur et visitez la page d'utilisation de Claude
+     - Ouvrez les outils de developpement (F12 ou Cmd + Option + I)
+     - Allez dans l'onglet « Reseau », rechargez la page
+     - Trouvez la requete `usage`, extrayez `sessionKey=sk-ant-...` depuis le Cookie
+     - Collez dans le champ de saisie
+
+### Utilisation quotidienne
+
+- **Affichage par defaut** - L'icone de la barre des menus affiche le pourcentage d'utilisation
+- **Voir les details** - Cliquez sur l'icone de la barre des menus
+- **Actualisation manuelle** - Cliquez sur le bouton d'actualisation ou utilisez le raccourci ⌘R
+- **Changer de compte** - Menu « … » dans la fenetre de detail ou clic droit sur l'icone
+- **Raccourcis clavier**
+  - ⌘R - Actualiser les donnees
+  - ⌘, - Ouvrir les reglages generaux
+  - ⌘⇧A - Ouvrir les reglages d'authentification
+  - ⌘Q - Quitter l'application
+
+---
+
+## ❓ FAQ
+
+<details>
+<summary><b>Q : Que faire si l'application affiche « Session expiree » ?</b></summary>
+
+R : Les Session Keys expirent periodiquement (generalement des semaines a des mois), il faut en obtenir une nouvelle :
+1. Ouvrez Reglages → Authentification
+2. Cliquez sur « Connexion via le navigateur » (recommande), ou obtenez manuellement une nouvelle Session Key
+3. C'est fait, la surveillance reprendra
+
+</details>
+
+<details>
+<summary><b>Q : Comment activer le lancement automatique au demarrage ?</b></summary>
+
+R : Deux methodes :
+
+**Methode 1 : Option integree (recommande)**
+1. Ouvrez Reglages → General
+2. Cochez « Demarrer automatiquement a la connexion »
+
+**Methode 2 : Via les Reglages Systeme**
+1. Ouvrez Reglages Systeme → General → Ouverture
+2. Cliquez sur « + » pour ajouter Usage4Claude
+
+</details>
+
+<details>
+<summary><b>Q : Combien de ressources systeme sont utilisees ?</b></summary>
+
+R : Tres leger :
+- Utilisation CPU : < 0,1 % (au repos)
+- Memoire : ~20 Mo
+- Reseau : Seulement 1 requete par minute
+
+</details>
+
+<details>
+<summary><b>Q : Quelles versions de macOS sont supportees ?</b></summary>
+
+R : Necessite macOS 13.0 (Ventura) ou ulterieur. Supporte les puces Intel et Apple Silicon (M1/M2/M3).
+
+</details>
+
+<details>
+<summary><b>Q : Pourquoi l'application demande-t-elle l'acces au trousseau ?</b></summary>
+
+R :
+- Le trousseau est le gestionnaire de mots de passe au niveau systeme de macOS
+- Votre Session Key est chiffree dans le trousseau
+- L'Organization ID est stocke dans la configuration locale (identifiant non sensible)
+- C'est la methode de stockage securise recommandee par Apple
+- Seule cette application peut acceder aux informations, les autres applications ne peuvent pas les consulter
+
+</details>
+
+<details>
+<summary><b>Q : Mes donnees sont-elles en securite ? Comment la confidentialite est-elle protegee ?</b></summary>
+
+**Entierement securise !**
+
+**Stockage des donnees :**
+- Toutes les donnees sont stockees **uniquement** sur votre Mac local
+- Aucune collecte, aucun suivi, aucune statistique
+- Aucune requete reseau en dehors des appels a l'API Claude
+- Aucun service tiers utilise
+
+**Securite de l'authentification :**
+- Session Key chiffree via le trousseau macOS (chiffrement au niveau systeme)
+- Le trousseau utilise le chiffrement AES-256 + protection materielle (T2 / Secure Enclave)
+- Seule cette application peut acceder a vos identifiants
+- Vous pouvez revoquer l'acces a tout moment via l'application « Trousseaux d'acces »
+
+**Transparence du code :**
+- 100 % open source
+- Pas d'obfuscation ni de fonctionnalites cachees
+- La communaute peut auditer et verifier
+
+</details>
+
+<details>
+<summary><b>Q : L'application fonctionne-t-elle avec Claude Code / l'app de bureau / l'app mobile ?</b></summary>
+
+R : **Oui, elle fonctionne avec toutes les plateformes Claude !**
+
+Puisque tous les produits Claude (Web, Claude Code, Application de bureau, Application mobile, Cowork) partagent le meme quota d'utilisation, Usage4Claude surveille votre utilisation combinee sur toutes les plateformes.
+
+</details>
+
+---
+
+## 📄 Licence
+
+Ce projet est sous licence MIT - voir le fichier [LICENSE](../LICENSE) pour plus de details
+
+---
+
+## 📞 Contact
+
+- **Issues** : [Soumettre un probleme ou une suggestion](https://github.com/f-is-h/Usage4Claude/issues)
+- **Discussions** : [Rejoindre les discussions](https://github.com/f-is-h/Usage4Claude/discussions)
+- **GitHub** : [@f-is-h](https://github.com/f-is-h)
+
+---
+
+## ⚖️ Avertissement
+
+Ce projet est un outil tiers independant sans affiliation officielle avec Anthropic ou Claude AI. Veuillez respecter les conditions d'utilisation de Claude AI lors de l'utilisation de ce logiciel.
+
+---
+
+<div align="center">
+
+**Si ce projet vous aide, n'hesitez pas a lui donner une ⭐ Star !**
+
+Fait avec ❤️ par [f-is-h](https://github.com/f-is-h)
+
+[⬆ Retour en haut](#usage4claude)
+
+</div>
diff --git a/docs/README.ja.md b/docs/README.ja.md
@@ -1,6 +1,6 @@
 # Usage4Claude
 
-[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md)
+[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Français](README.fr.md)
 
 <div align="center">
 

diff --git a/docs/README.ko.md b/docs/README.ko.md
@@ -1,6 +1,6 @@
 # Usage4Claude
 
-[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md)
+[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Français](README.fr.md)
 
 <div align="center">
 

diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md
@@ -1,6 +1,6 @@
 # Usage4Claude
 
-[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md)
+[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Français](README.fr.md)
 
 <div align="center">
 

diff --git a/docs/README.zh-TW.md b/docs/README.zh-TW.md
@@ -1,6 +1,6 @@
 #  Usage4Claude
 
-[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md)
+[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Français](README.fr.md)
 
 <div align="center">