AIUsageWatch
Trợ giúp và thông tin

Kết nối tài khoản của bạn.
Hiểu số liệu bạn đang xem.

Từ tài khoản đầu tiên đến việc hiểu số liệu đã lưu, đây là cách AIUsageWatch hoạt động trên Mac của bạn.

Yêu cầu và thông tin phát hành

AIUsageWatch là ứng dụng gốc miễn phí trên thanh menu dành cho macOS 14 trở lên. Bản phát hành công khai đang được chuẩn bị. Liên kết tải xuống đã xác minh sẽ được thêm vào trang web này khi có. Tài khoản và phí gói của nhà cung cấp tách biệt với ứng dụng.

Chuyển ứng dụng đã phát hành vào Applications trước khi bật Mở khi đăng nhập. Ứng dụng nằm trên thanh menu và không cần biểu tượng Dock. Mở ứng dụng đang chạy từ Finder sẽ đưa Tùy chọn lên phía trước.

Kết nối các nhà cung cấp của bạn

  1. Codex: cài đặt và đăng nhập vào Codex CLI. Trỏ tài khoản tới thư mục cấu hình của nó, thường là ~/.codex. Ứng dụng dùng thông tin đăng nhập đã lưu của thư mục đó qua app-server của CLI cục bộ.
  2. Claude: tài khoản mặc định ~/.claude sử dụng phiên của bạn tại claude.ai trong Safari. Trong Tùy chọn, cấp quyền truy cập tệp Cookies.binarycookies của Safari. Đối với thư mục cấu hình Claude riêng, đăng nhập bằng Claude Code với CLAUDE_CONFIG_DIR; ứng dụng đọc tệp .credentials.json.
  3. Cursor: đăng nhập tại cursor.com trong Safari và cấp quyền truy cập tệp cookie Safari trong Tùy chọn. Cursor không dùng thư mục tài khoản để đọc số liệu.
  4. Grok: chọn thư mục Grok chứa logs/unified.jsonl. Chạy Grok để cập nhật số liệu thanh toán trong nhật ký đó.

Ứng dụng đọc thông tin hạn mức có sẵn từ từng nguồn. Các nguồn CLI của Claude và Codex cần thông tin đăng nhập đã lưu tương ứng. Bản xem trước trên trang web không bao giờ truy cập tài khoản của bạn.

Tài khoản cá nhân và công việc cùng nhau

Mở Tùy chọn… từ menu, hoặc nhấn ⌘,. Mỗi tài khoản có nhãn, nhà cung cấp, thư mục, màu sắc và chữ cái. Dùng + để thêm thư mục; ứng dụng đoán nhà cung cấp từ nội dung thư mục. Kiểm tra nhà cung cấp trước khi dùng tài khoản mới.

Đối với thông tin đăng nhập Codex khác, chọn CODEX_HOMEriêng của nó. Đối với thông tin đăng nhập Claude khác, dùng một CLAUDE_CONFIG_DIR riêng với thông tin xác thực đã lưu riêng. Phiên Claude Safari mặc định có thể không xác định rõ được tài khoản khi chứa nhiều tổ chức; hãy dùng thư mục cấu hình riêng trong trường hợp đó. Công cụ đọc dữ liệu Cursor dùng phiên Safari hiện có, nên thêm một hàng Cursor trùng lặp không tạo ra thông tin đăng nhập độc lập.

Thêm tài khoản sẽ thêm cột, với tối đa ba hàng trong mỗi cột. Chữ cái và màu sắc tùy chỉnh giúp nhận diện tài khoản. Cài đặt chung gồm thời điểm làm mới, vạch phần trăm, chữ cái và cảnh báo thông tin hết hạn lượt đặt lại hạn mức để dành của Codex khi được hỗ trợ.

Hiểu các thanh

Phần được tô biểu thị hạn mức còn lại. Khi còn 0%, không có phần thanh được tô. Màu sắc giúp nhận diện tài khoản. Menu hiển thị tỷ lệ phần trăm, thời điểm đặt lại khi có, chi tiết chu kỳ liên quan và trạng thái số liệu.

Claude có chi tiết hằng tuần và chu kỳ năm giờ khi có; Codex chọn giới hạn tuần chính. Cursor dùng số liệu mức sử dụng trong gói riêng, với dữ liệu trả về không nêu kỳ sử dụng. Grok dùng số liệu tín dụng hằng tuần từ nhật ký CLI. Tỷ lệ phần trăm của các nhà cung cấp khác nhau không tương đương về số token, câu lệnh hay đô la.

Nhận ra lượt đặt lại hạn mức để dành của Codex trước khi hết hạn

Khi Codex báo cáo các lượt đặt lại hạn mức để dành hiện có và ngày hết hạn, AIUsageWatch có thể hiển thị chấm cảnh báo bên cạnh tài khoản trước khi lượt đặt lại hạn mức để dành tiếp theo hết hạn. Mở menu để xem số lượt hiện có và thông tin hết hạn. Một lượt đặt lại hạn mức để dành chưa dùng có thể mất khi hết hạn; điều này khác với thời điểm hạn mức hằng tuần của bạn được đặt lại như thông thường.

Bật Cảnh báo trước khi đặt lại trong Tùy chọn và chọn trước 1–14 ngày. Mặc định là hai ngày với chấm cảnh báo đỏ; bạn có thể đổi màu. Chấm vẫn hiển thị khi tắt chữ cái tài khoản. Cảnh báo phụ thuộc vào việc ứng dụng đang chạy, cảnh báo được bật và dữ liệu hết hạn có sẵn, cập nhật. Tính năng không tự động dùng lượt đặt lại hạn mức để dành hay gửi thông báo hệ thống.

Yêu cầu khởi động tự động của Codex

Khi số liệu Codex trực tiếp cho biết hạn mức hằng tuần còn 100%, AIUsageWatch gửi một yêu cầu nhỏ codex exec bằng thông tin đăng nhập CLI đã lưu của thư mục đó. Mục đích là bắt đầu chu kỳ tuần có thể vẫn chưa khởi động. Yêu cầu dùng mô hình mặc định khả dụng của Codex và tiêu tốn một phần nhỏ hạn mức của tài khoản đó.

Chấm đỏ đánh dấu tài khoản khi yêu cầu đang chạy hoặc nếu yêu cầu thất bại. Menu giải thích trạng thái và cung cấp tùy chọn thử lại thủ công. Ứng dụng ghi nhớ lần thử trong bộ nhớ cho chu kỳ tuần đó. Thăm dò lặp lại không gửi thêm yêu cầu cho lần thử đã được ghi nhớ; khởi chạy lại xóa bộ nhớ này và có thể dẫn đến thêm một yêu cầu nếu số liệu trực tiếp vẫn là 100%.

Dữ liệu dự phòng từ bản ghi phiên trong quá khứ không gửi yêu cầu khởi động. Yêu cầu khởi động tự động của Claude chưa được bật trong bản dựng hiện tại. Điều này tách biệt với việc đọc mức sử dụng, và Tùy chọn hiện tại không có nút bật/tắt yêu cầu khởi động Codex.

Số liệu đã cũ, bị thiếu hoặc bất thường

Điểm cuối và dữ liệu trả về của nhà cung cấp có thể thay đổi. Số liệu không đảm bảo nhà cung cấp sẽ chấp nhận yêu cầu tiếp theo. Kiểm tra trang tài khoản của nhà cung cấp khi số dư hoặc thời điểm đặt lại có vẻ sai.

Cài đặt cục bộ và kết nối nhà cung cấp

Tùy chọn và số liệu lưu đệm nằm trong ~/Library/Application Support/AiUsageWatch/. Ứng dụng không đọc trực tiếp Chuỗi khóa. CLI của nhà cung cấp tự quản lý cách đăng nhập. Các công cụ đọc dữ liệu trực tiếp liên hệ nhà cung cấp tương ứng bằng phiên hoặc thông tin xác thực hiện có. Đọc chính sách quyền riêng tư để phân biệt dữ liệu ứng dụng lưu cục bộ, kết nối nhà cung cấp và tin nhắn hỗ trợ.

Báo cáo sự cố

Liên hệ bộ phận hỗ trợ AIUsageWatch kèm phiên bản ứng dụng, phiên bản macOS, nhà cung cấp, trạng thái số liệu và các bước tái hiện sự cố. Nếu bạn dùng chế độ chẩn đoán --dump , hãy xem lại đầu ra trước khi gửi. Loại bỏ token xác thực, giá trị cookie, đường dẫn tài khoản riêng tư và mọi thông tin nhạy cảm khác. Không tải lên tệp thông tin xác thực.