Đọc live usage an toàn

OreoDeck xin macOS Keychain cấp OAuth credential sẵn có của Claude Code profile đã chọn, rồi đọc usage và account identity khả dụng cho đúng profile đó. Credential cần scope `user:profile`. OreoDeck không hiển thị, export hoặc yêu cầu bạn paste OAuth token.

Usage được giới hạn theo profile. Refresh thành công nghĩa là app đọc được account đã chọn; nó không cấp quyền truy cập profile khác.

Hiểu các dòng quota

Một account đã kết nối có thể trả về five-hour, Weekly, Fable weekly, Usage credits hoặc limit khác. Mỗi dòng có phần trăm đã dùng và reset time khi Claude trả về. Plan/account khác nhau có thể nhận bucket khác nhau, nên thiếu một dòng không tự nó là lỗi.

Refresh và đăng nhập lại

Dùng Refresh usage để cập nhật ngay hoặc chọn refresh interval trong Settings. OreoDeck chỉ prompt Keychain khi cần credential của profile đã chọn. Dashboard gắn nhãn Live, Last snapshot hoặc Sign in để stale data không bao giờ được hiển thị như live request thành công.

Khi app nói Sign in hoặc đăng nhập lại, chọn Login again và hoàn tất Claude Code login trong Terminal. Sau đó quay lại OreoDeck và refresh đúng profile đó; không cần chuyển token.

Troubleshoot usage không khả dụng

Chỉ có MCP OAuth state

Một số phiên bản Claude Code chỉ lưu MCP OAuth state mà không có Claude login credential dùng được. OreoDeck đánh dấu đây là lỗi login state và không gửi background usage request.

Thiếu user:profile

Token chỉ có inference không thể đọc account usage. Đăng nhập lại qua Claude Code để credential có scope `user:profile` cần thiết.

Không đọc được Keychain

Mở khóa macOS user session hiện tại và chấp nhận Keychain prompt cho OreoDeck. Nếu vẫn không truy cập được, dùng Login again thay vì copy credential giữa các profile.