#  Usage4Claude

[English](../README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Français](README.fr.md) | [Deutsch](README.de.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)

**在選單列中優雅地追蹤您的 Claude（以及 Codex）訂閱用量。**

✨ **支持監控所有Claude平台: Web • Claude Code • Desktop • Mobile App • Cowork** ✨

[功能特性](#-功能特性) • [下載安裝](#-下載安裝) • [使用指南](#-使用指南) • [常見問題](#-常見問題) • [支持專案](#-支持專案)

</div>

---

## ✨ 功能特性

### 🎯 核心功能

- **📊 即時監控** - 在選單列即時顯示 Claude 訂閱（Free/Pro/Team/Max）的使用配額，並可選監控 Codex 用量
- **🎯 多限制支援** - Claude 支援 5小時、7天與額外用量限制，並支援任意數量模型的每週用量（如 Opus、Sonnet、Fable），Codex 支援 5小時、7天與額外用量/credits
- **🎨 智慧顯示模式** - 自動檢測並顯示所有有數據的限制類型
- **⚙️ 自訂顯示** - 手動選擇要顯示的限制類型，支援任意組合
- **🎨 智慧色彩** - 根據使用率自動變色提醒，不同限制類型擁有各自的色彩方案
- **🔔 用量通知** - 用量達到 90% 時發送警告通知，配額重置時發送重置通知
- **👥 多帳戶管理** - 支援 Claude 多帳戶 / 同一帳戶多組織，也支援獨立的 Codex 帳戶管理與快速切換
- **🧩 Codex 支援** - 可選的 Codex 用量監控；可單獨使用 Codex，也可與 Claude 並列顯示為雙欄視圖（在設定中新增 Codex 帳號即可啟用）
- **🌐 內建瀏覽器登入** - Claude 登入自動擷取 Session Key；Codex 透過內建瀏覽器登入 ChatGPT 取得認證資訊
- **🎨 外觀設定** - 支援跟隨系統 / 淺色 / 深色三種外觀模式
- **🕐 時間格式** - 支援系統預設 / 12小時制 / 24小時制
- **⏰ 精確計時** - 精確到分鐘的配額重置時間顯示
- **🔄 智慧刷新系統** - 智惠4級自適應刷新或固定間隔（1/3/5/10分鐘）
- **⚡ 手動重新整理** - 點擊重新整理按鈕後立即更新資料（並具有 10 秒防抖保護）
- **💻 原生體驗** - 純原生 macOS 應用程式，輕量且優雅

### 🌐 跨平台支持

無縫支持所有Claude產品:
- 🌐 **Claude.ai** (Web界面)
- 💻 **Claude Code** (開發者CLI工具)
- 🖥️ **Desktop App** (macOS/Windows)
- 📱 **Mobile App** (iOS/Android)
- 🤝 **Cowork** (AI代理)

所有平台共享同一使用配額，在一個地方監控！

### 🧩 Codex 支援

- 可單獨監控 Codex 用量，也可與 Claude 一起顯示
- 支援 Codex 5小時、7天與額外用量/credits 資訊
- 透過內建瀏覽器登入 ChatGPT 新增 Codex 帳戶
- Claude-only 使用者無需額外設定；未新增 Codex 帳戶時介面保持原有體驗

### 🎨 個人化

- **🕓 多種顯示模式**
  - 僅顯示百分比 - 簡潔直觀，無須點擊即可查看
  - 僅顯示圖示 - 低調優雅，點擊後顯示詳細資訊
  - 圖示 + 百分比 - 資訊完整，視覺定位快速易識別

- **🌍 多語言支援**
  - English
  - 日本語
  - 简体中文
  - 繁體中文
  - 한국어
  - Français（由 [@mtreize](https://github.com/mtreize) 貢獻）
  - Deutsch（由 [@schaitl](https://github.com/schaitl) 貢獻）
  - 更多語言適配中……（歡迎提交本地化 PR！）

### 🔧 便捷功能

- **⚙️ 視覺化設定** - 無需修改程式碼，圖形化設定所有選項
- **🆕 智慧更新提醒** - 選單列徽章和彩虹動畫提示新版本
- **🚀 開機啟動選項** - 可選擇系統啟動時自動執行
- **⌨️ 鍵盤快速鍵支援** - 常用操作支援鍵盤快速鍵（⌘R | ⌘, | ⌘Q）
- **👋 友善引導** - 首次啟動提供詳細的設定精靈
- **… 選單顯示** - 多種選單存取方式，詳情檢視和右鍵
- **🔔 用量通知** - 支援 Claude 用量警告和重置通知，可在設定中開關
- **🛠️ 除錯模式** - 開發者選項：Claude/Codex 假資料測試、模擬更新、即時重新整理

### 🔒 安全與隱私

- 🏠 **僅本機儲存** - 所有資料僅儲存在本機，絕不收集和上傳任何個人資訊
- 🔐 **Keychain 保護** - Claude Session Key 與 Codex 認證權杖使用 Keychain 儲存，無明文金鑰
- 📖 **開源透明** - 程式碼完全公開，任何人都可稽核
- 🛡️ **Sandbox 防護** - 啟用 App Sandbox，增強安全性

---

## 📸 截圖預覽

### 選單列顯示效果

- 以下展示 Claude 與 Codex 的選單列圖示與限制指示
- 圖形形狀與顏色雙重指示，保證在單色主題下仍容易識別

| 圖示 | 5小時 | 7天 | 額外用量 | 7天 Opus | 7天 Sonnet | 單色(自適應) |
|:---:|:---:|:---:|:---:|:---:|:---:|-----|
| <img src="images/bar.icon@2x.png" width="40" height="40" alt="icon"> | <img src="images/bar.5h@2x.png" width="45" height="45" alt="5h ring"> | <img src="images/bar.7d@2x.png" width="45" height="45" alt="7d ring"> | <img src="images/bar.ex@2x.png" width="45" height="45" alt="extra ring"> | <img src="images/bar.7do@2x.png" width="45" height="45" alt="7d opus ring"> | <img src="images/bar.7ds@2x.png" width="45" height="45" alt="7d sonnet ring"> | <img src="images/bar.mono.b@2x.png" width="auto" height="35" alt="mono black"></br> <img src="images/bar.mono.w@2x.png" width="auto" height="35" alt="mono white"> |
| <img src="images/bar.icon.codex@2x.png" width="40" height="40" alt="codex icon"> | <img src="images/bar.5h.codex@2x.png" width="45" height="45" alt="codex 5h ring"> | <img src="images/bar.7d.codex@2x.png" width="45" height="45" alt="codex 7d ring"> | <img src="images/bar.ex.codex@2x.png" width="45" height="45" alt="codex extra ring"> | — | — | <img src="images/bar.mono.b.codex@2x.png" width="auto" height="35" alt="codex mono black"></br> <img src="images/bar.mono.w.codex@2x.png" width="auto" height="35" alt="codex mono white"> |

**顏色指示**：

Claude 目前配色：

- **5小時用量限制（含詳情視窗）**：![macOS綠色](https://img.shields.io/badge/macOS綠色-34C759) → ![macOS橙色](https://img.shields.io/badge/macOS橙色-FF9500) → ![macOS紅色](https://img.shields.io/badge/macOS紅色-FF3B30)
- **7天用量限制（含詳情視窗）**：![淺紫色](https://img.shields.io/badge/淺紫色-C084FC) → ![紫色](https://img.shields.io/badge/紫色-B450F0) → ![深紫色](https://img.shields.io/badge/深紫色-B41EA0)
- **額外使用量**：![粉色](https://img.shields.io/badge/粉色-FF9ECD) → ![玫紅色](https://img.shields.io/badge/玫紅色-EC4899) → ![紫紅色](https://img.shields.io/badge/紫紅色-D946EF)
- **7天 Opus 用量限制**：![淺橙色](https://img.shields.io/badge/淺橙色-FFC864) → ![琥珀色](https://img.shields.io/badge/琥珀色-FBBF24) → ![橙紅色](https://img.shields.io/badge/橙紅色-FF6432)
- **7天 Sonnet 用量限制**：![淺藍色](https://img.shields.io/badge/淺藍色-64C8FF) → ![藍色](https://img.shields.io/badge/藍色-007AFF) → ![靛藍色](https://img.shields.io/badge/靛藍色-4F46E5)

Codex 目前配色：

- **Codex 5小時限制**：![亮松石](https://img.shields.io/badge/亮松石-2DD4BF) → ![深松石](https://img.shields.io/badge/深松石-0D9488) → ![最深松石](https://img.shields.io/badge/最深松石-134E4A)
- **Codex 7天限制**：![天空藍](https://img.shields.io/badge/天空藍-60A5FA) → ![藍色](https://img.shields.io/badge/藍色-2563EB) → ![深藍](https://img.shields.io/badge/深藍-1E3A8A)
- **Codex 額外用量 / credits**：![金色](https://img.shields.io/badge/金色-F59E0B) → ![深金色](https://img.shields.io/badge/深金色-D97706) → ![最深琥珀](https://img.shields.io/badge/最深琥珀-78350F)

### 詳情視窗

<table border="0">
<tr>
<td align="top" valign="top">
<img src="images/detail.claude.zh-TW@2x.png" width="280" alt="Claude 單獨使用模式">
<br/>
<sub><i>Claude 單獨使用模式</i></sub>
</td>
<td align="center" valign="top">
<img src="images/detail.codex.zh-TW@2x.png" width="280" alt="Codex 單獨使用模式">
<br/>
<sub><i>Codex 單獨使用模式</i></sub>
</td>
</tr>
<tr>
<td align="center" valign="top" colspan="2">
<img src="images/detail.both.zh-TW@2x.png" width="560" alt="Claude 和 Codex 共存模式">
<br/>
<sub><i>Claude + Codex 共存模式</i></sub>
</td>
</tr>
<tr>
<td align="center" valign="top" colspan="2">
<img src="images/detail@2x.gif" width="280" alt="切換動畫">
<br/>
<sub><i>剩餘時間切換動畫</i></sub>
</td>
</tr>
</table>

### 設定介面

**一般設定** - 顯示選項、選單列主題、通知設定、外觀（跟隨系統/淺色/深色）、刷新模式、時間格式、語言選項、開機啟動
**認證資訊** - Claude/Codex 帳戶管理（新增/刪除/切換/別名編輯）、內建瀏覽器登入、Claude 手動輸入、連線診斷
**關於** - 版本資訊和相關連結

### 歡迎畫面

**設定認證資訊** - Claude 支援內建瀏覽器一鍵登入（推薦）或手動輸入 Session Key，自動獲取 Organization ID，支援同一 Session Key 下的多組織自動建立；Codex 可在設定中透過內建瀏覽器登入 ChatGPT 新增
**設定顯示選項** - 選單列主題、顯示內容、顯示模式（智慧/自訂）選擇，支援即時預覽
**稍後設定** - 關閉歡迎視窗，稍後可在設定介面中進行設定

---

## 💾 下載安裝

### 方式一：下載預編譯版本（推薦）

1. 前往 [Releases 頁面](https://github.com/f-is-h/Usage4Claude/releases)
2. 下載最新版本的 `.dmg` 檔案
3. 雙擊開啟，將應用程式拖入「應用程式」資料夾
4. 首次執行時，右鍵點擊應用程式選擇「開啟」（需要允許執行未簽署應用程式）
5. 需要允許使用 Keychain 儲存認證資訊（版本更新後可能需要再次允許。授權視窗會顯示對應的認證權杖名稱）

### 方式二：從原始碼建置

#### 前置要求
- macOS 13.0 或更高版本
- Xcode 15.0 或更高版本
- Git

#### 建置步驟

```bash
# 複製儲存庫
git clone https://github.com/f-is-h/Usage4Claude.git
cd Usage4Claude

# 在 Xcode 中開啟
open Usage4Claude.xcodeproj

# 在 Xcode 中按 Cmd + R 執行
```

---

## 📖 使用指南

### 首次設定

1. **啟動應用程式**
   首次執行會顯示歡迎畫面

2. **設定認證資訊**
   - **Claude 方式一：瀏覽器登入（推薦）**
     - 點擊「瀏覽器登入」按鈕
     - 在內建瀏覽器中登入 Claude 帳戶
     - 登入成功後自動擷取 Session Key 並完成設定
   - **Claude 方式二：手動輸入**
     - 開啟瀏覽器存取 Claude 用量頁面
     - 開啟開發者工具（F12 或 Cmd + Option + I）
     - 切換到「網路」分頁，重新整理頁面
     - 找到 `usage` 請求，從 Cookie 中擷取 `sessionKey=sk-ant-...`
     - 貼上到輸入框
   - **Codex 帳戶（可選）**
     - 開啟設定 → 認證資訊
     - 點擊 Codex 的「瀏覽器登入」
     - 在內建瀏覽器中登入 ChatGPT 帳戶
     - 登入成功後自動儲存認證資訊
     - Codex 目前不支援手動輸入 Session Key

### 日常使用

- **預設顯示** - 選單列圖示顯示使用量百分比
- **查看詳情** - 點擊選單列圖示即可查看詳情；僅設定 Claude/Codex 時顯示 Claude/Codex 單列，同時設定 Claude 與 Codex 時顯示雙欄視圖
- **手動重新整理** - 詳情視窗點擊重新整理按鈕或使用快速鍵 ⌘R（開啟主介面時也會自動重新整理資料）；雙欄視圖中也可分別重新整理 Claude 或 Codex
- **切換帳戶** - 在詳情視窗點擊「…」選單或右鍵點擊選單列圖示，選擇要切換的 Claude / Codex 帳戶
- **鍵盤快速鍵操作**
  - ⌘R - 手動重新整理資料
  - ⌘, - 開啟一般設定
  - ⌘⇧A - 開啟認證設定
  - ⌘U - 檢查更新
  - ⌘Q - 結束應用程式
- **更新提醒** - 有新版本時選單列圖示顯示徽章，選單項目顯示彩虹文字
- **檢查更新** - 選單 → 檢查更新

### 刷新模式

**智慧頻率（推薦）**
- 根據使用情況自動調整刷新間隔
- 活躍模式（1分鐘）- 正在使用 Claude 或 Codex 時快速刷新
- 靜默模式（3/5/10分鐘）- 靜默時逐步減慢刷新
- 靜默期間顯著減少 API 呼叫（最多10倍）
- 檢測到使用變化後立即恢復到1分鐘刷新
- 系統從睡眠喚醒後會自動重新整理，避免長時間停留在舊資料

**固定頻率**
- **1分鐘** - 推薦的持續監控
- **3分鐘** - 平衡監控
- **5分鐘** - 低頻監控
- **10分鐘** - 最少 API 呼叫

---

## ❓ 常見問題

<details>
<summary><b>Q: 應用程式顯示「工作階段已過期」該怎麼辦？</b></summary>

A: Claude Session Key 或 Codex 認證權杖會定期過期（通常幾週到幾個月），需要重新登入：
1. 開啟設定 → 認證資訊
2. Claude 帳戶可點擊「瀏覽器登入」重新登入（推薦），也可按照手動方式重新取得 Session Key
3. Codex 帳戶請點擊 Codex 的「瀏覽器登入」，在內建瀏覽器中重新登入 ChatGPT
4. 完成後即可恢復正常

</details>

<details>
<summary><b>Q: 如何讓應用程式開機自動啟動？</b></summary>

A: 有兩種方式：

**方式一：使用應用程式內建選項（推薦）**
1. 開啟設定 → 一般設定
2. 勾選「登入時啟動」選項

**方式二：透過系統設定**
1. 開啟「系統設定」→「一般」→「登入項目」
2. 點擊「+」新增 Usage4Claude

</details>

<details>
<summary><b>Q: 應用程式佔用多少系統資源？</b></summary>

A: 非常輕量：
- CPU 使用率：< 0.1%（閒置時）
- 記憶體佔用：約 20MB
- 網路請求：預設按智慧頻率重新整理；同時設定 Claude 與 Codex 時會分別請求對應服務

</details>

<details>
<summary><b>Q: 支援哪些 macOS 版本？</b></summary>

A: 需要 macOS 13.0 (Ventura) 或更高版本。支援 Intel 和 Apple Silicon (M1/M2/M3/M4/M5) 晶片。

</details>

<details>
<summary><b>Q: 為什麼需要 Keychain 權限？</b></summary>

A:
- Keychain 是 macOS 的系統級密碼管理工具
- Claude Session Key 與 Codex 認證權杖會被加密儲存在 Keychain 中
- Claude Organization ID 儲存在本機設定中（非敏感標識符）
- 這是 Apple 建議的最安全的敏感資訊儲存方式
- 只有本應用程式可以存取這些資訊，其它應用程式無權查看

</details>

<details>
<summary><b>Q: 我的資料安全嗎？隱私如何保護？</b></summary>

**完全安全！** 

**資料儲存：**
- 所有資料**僅**儲存在您本機 Mac 上
- 不收集、不追蹤、不統計任何資訊
- 除了呼叫 Claude 與 Codex 相關用量介面外無其他網路請求
- 不使用任何第三方服務

**認證資訊安全：**
- Claude Session Key 與 Codex 認證權杖透過 macOS Keychain 加密（系統級加密）
- Keychain 使用 AES-256 加密 + 硬體保護（T2 / Secure Enclave）
- 僅本應用程式可存取您的憑證，其他應用程式無法讀取
- 您可隨時透過「鑰匙圈存取」應用程式撤銷權限

**程式碼透明性：**
- 100% 開源
- 無混淆或隱藏功能
- 社群可稽核和驗證

**額外保護：**
- 啟用 App Sandbox（限制系統存取）
- 無權存取您的檔案、聯絡人或其他應用程式
- 最小化權限（僅網路 + Keychain）

您可以透過 GitHub 查看原始程式碼來驗證這一切！

</details>

<details>
<summary><b>Q: 是否支持 Claude Code / Desktop App / Mobile App?</b></summary>

A: **是的，支持所有Claude平台！**

由於所有Claude產品 (Web, Claude Code, Desktop App, Mobile App, Cowork) 共享同一使用配額，Usage4Claude會監控您在所有平台上的總使用量。

無論您是:
- 在終端使用 `claude code` 編程
- 在 claude.ai 聊天
- 使用桌面應用程式
- 使用手機應用程式
- 使用 Cowork 代理

您都能在選單列中看到即時的總使用量。無需特定平台的配置！

</details>

<details>
<summary><b>Q: Codex 支援如何啟用？可以只用 Codex 嗎？</b></summary>

A: 可以。開啟設定 → 認證資訊，點擊 Codex 的「瀏覽器登入」，在內建瀏覽器中登入 ChatGPT 後即可啟用。

- 只設定 Codex：選單列和詳情視窗會顯示 Codex 用量
- 同時設定 Claude 與 Codex：詳情視窗會以雙欄視圖並列顯示兩者
- Codex 目前僅支援瀏覽器登入，不支援手動輸入 Session Key

</details>

<details>
<summary><b>Q: 選單列看不到圖示怎麼辦？</b></summary>

A: macOS 系統或第三方軟體（如 Bartender、Hidden Bar 等）有時會自動隱藏選單列圖示。

**解決方法：**
1. 按住 **Command (⌘) 鍵**
2. 用滑鼠拖曳選單列中的圖示
3. 將 Usage4Claude 圖示拖到選單列右側可見區域
4. 鬆開滑鼠即可

**提示：**
- macOS Sonoma (14.0+) 會自動隱藏不常用的圖示到「控制中心」
- 您可以在「系統設定」→「控制中心」中調整選單列圖示顯示

</details>

<details>
<summary><b>Q: 如何管理多個帳戶？</b></summary>

A: Usage4Claude 支援 Claude 多帳戶、同一 Claude 帳戶下的多組織，以及獨立的 Codex 帳戶管理：
- **新增帳戶** - 在設定 → 認證資訊中透過 Claude 瀏覽器登入、Claude 手動輸入或 Codex 瀏覽器登入新增
- **切換帳戶** - 在詳情視窗點擊「…」選單或右鍵點擊選單列圖示，選擇要切換的 Claude / Codex 帳戶
- **編輯別名** - 為每個帳戶設定易於辨識的別名
- **刪除帳戶** - 左滑或透過編輯模式移除不需要的帳戶

</details>

<details>
<summary><b>Q: 如何開啟用量通知？</b></summary>

A: 在設定 → 一般設定中可以開關 Claude 用量通知功能：
- **用量警告** - 當 Claude 使用量達到 90% 時發送系統通知
- **重置通知** - 當 Claude 配額重置時發送通知提醒
- 首次開啟時需要授權 macOS 通知權限

</details>

---

## 🛠 技術堆疊

本專案採用現代 macOS 原生技術堆疊建置：

- **語言**: Swift 5.0+
- **UI 框架**: SwiftUI + AppKit 混合
- **架構**: MVVM
- **網路**: URLSession
- **響應式**: Combine Framework
- **本地化**: 內建 i18n 支援
- **平台**: macOS 13.0+

---

## 🗺 路線圖

### ✅ 已完成
- [x] 基礎監控功能
- [x] 選單列即時顯示
- [x] 圓形進度指示器
- [x] 智慧顏色提醒
- [x] 即時倒數計時
- [x] 選單列多種顯示模式
- [x] 視覺化設定介面
- [x] 多語言支援
- [x] 首次啟動引導
- [x] 更新檢查
- [x] 認證資訊 Keychain 儲存
- [x] Shell 自動打包 DMG
- [x] GitHub Actions 自動發布
- [x] 設定介面視覺優化
- [x] 開機啟動設定
- [x] 快速鍵支援
- [x] 手動重新整理功能
- [x] 三點選單黑暗模式適配
- [x] 雙限制模式支援（5小時 + 7天）
- [x] 雙圓環選單列圖示
- [x] 統一配色方案管理
- [x] 除錯模式（假資料、模擬更新）
- [x] 詳情視窗 移除Focus 狀態
- [x] 多限制類型支援（5種）
- [x] 智慧/自訂顯示模式
- [x] 自動獲取 Organization ID
- [x] 優化的歡迎流程
- [x] 單色主題圖示顯示
- [x] 韓語支援
- [x] GitHub Actions 檢查線上版本
- [x] 外觀設定（跟隨系統/淺色/深色）
- [x] 內建瀏覽器自動取得認證資訊
- [x] 認證資訊自動設定
- [x] 用量通知提醒
- [x] 多帳戶管理
- [x] 統一時間格式設定
- [x] 設定介面黑暗模式適配
- [x] Codex 用量監控支援
- [x] Codex 單獨使用模式
- [x] Claude + Codex 雙欄詳情視窗
- [x] Codex 帳戶管理與瀏覽器登入
- [x] 法語本地化
- [x] 系統睡眠喚醒後自動重新整理資料

### 中期計畫
1. **功能增加**
    - 更多語言本地化

### 長期願景
2. **更多顯示方式**
   - 桌面小工具
   - 瀏覽器擴充功能圖示用量顯示

3. **資料分析**
   - 歷史使用記錄
   - 趨勢圖表展示

4. **多平台支援**
   - iOS / iPadOS 版本
   - Apple Watch 版本
   - Windows 版本

---

## 🤝 貢獻

歡迎所有形式的貢獻！無論是新功能、Bug 修復還是文件改進。

詳細的貢獻指南，請參閱 [CONTRIBUTING.md](../CONTRIBUTING.md)。

### 如何貢獻

1. Fork 本儲存庫
2. 建立您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的變更 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 開啟一個 Pull Request

### 貢獻者

感謝所有為這個專案做出貢獻的人！

<!-- ALL-CONTRIBUTORS-LIST:START -->
<!-- 這裡將自動產生貢獻者清單 -->
<!-- ALL-CONTRIBUTORS-LIST:END -->

---

## 📝 更新日誌

詳細的版本歷史和更新內容，請參閱 [CHANGELOG.md](../CHANGELOG.md)。

---

## 💖 支持專案

如果這個專案對您有幫助，歡迎透過以下方式支持：

### ⭐ Star 專案
給專案一個 Star 是對我最大的鼓勵！

### ☕ 請我喝杯咖啡

<!-- GitHub Sponsors -->
<a href="https://github.com/sponsors/f-is-h?frequency=one-time">
  <img src="https://img.shields.io/badge/GitHub-Sponsor-EA4AAA?style=for-the-badge&logo=github" alt="GitHub Sponsor">
</a>

<!-- Ko-fi -->
<a href="https://ko-fi.com/1attle">
  <img src="https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=for-the-badge&logo=ko-fi" alt="Ko-fi">
</a>

<!-- Buy Me A Coffee -->
<!-- <a href="https://buymeacoffee.com/fish_">
  <img src="https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me A Coffee">
</a> -->

### 📢 分享專案
如果您喜歡這個專案，請分享給更多可能需要的人！

---

## 📄 授權條款

本專案採用 MIT 授權條款 - 詳見 [LICENSE](../LICENSE) 檔案

```
MIT License

Copyright (c) 2025-2026 f-is-h

您可以自由地使用、複製、修改、合併、發布、分發、再授權和/或販售本軟體的副本。
```

---

## 🙏 致謝

- 感謝 Claude/Codex 大部分程式碼均由 AI 撰寫
- 感謝所有貢獻者和使用者的支持
- 圖示設計靈感來自 Claude/Codex 官方品牌

---

## 📞 聯絡方式

- **Issues**: [提交問題或建議](https://github.com/f-is-h/Usage4Claude/issues)
- **Discussions**: [參與討論](https://github.com/f-is-h/Usage4Claude/discussions)
- **GitHub**: [@f-is-h](https://github.com/f-is-h)

---

## ⚖️ 免責聲明

本專案是一個獨立的第三方工具，與 Anthropic、Claude AI、OpenAI 或 Codex 沒有官方關聯。使用本軟體時請遵守相關服務條款。

---

<div align="center">

**如果這個專案對您有幫助，請給一個 ⭐ Star！**

Made with ❤️ by [f-is-h](https://github.com/f-is-h)

[⬆ 回到頂部](#usage4claude)

</div>