Tokens left?

Mac setup and settings맥 설치와 설정

Before you start

• Sign in with the same Apple Account on your iPhone and Mac, and turn on password syncing on both.
• Use Claude Code (Pro or Max) or Codex (signed in with ChatGPT) on the Mac. Limits appear once you use them.

Install

1. Open the downloaded file and drag Tokens left into Applications.
2. Open Tokens left. Its icon appears in the menu bar: a rocket circling the ring, drawing a gauge of what is left. The first time, macOS asks whether to open an app downloaded from the internet: click Open. The settings window opens first.
3. In the settings window, click Connect Claude Code. Your usual Claude Code status line keeps showing.
4. Turn on Open at Login. The Mac app then opens by itself after a restart and keeps sending. macOS only shows a Background Items Added notice.
5. Codex needs nothing extra; the Mac app checks it every 5 minutes. On your iPhone, turn on Show subscription limits in the Tokens left? settings. When it shows Mac app: Connected, you are ready. On the Mac, click the menu bar icon to see when it last sent to your iPhone. The iPhone app is a free companion for subscription usage, without ads or mobile app tiers. A Mac license can be purchased optionally in the app and its key registered on Mac. The Mac app is required to receive actual usage; the 7-day Mac trial covers one selected account. After expiry, usage locks while settings and license registration remain available. A valid license unlocks all accounts.

Menu bar and settings

• From version 1.0 (46), choose System, Light or Dark under General > Theme in the Mac settings. On iPhone, use Settings > Home Screen > Theme. Each device keeps its own choice. Regular Home Screen widgets follow the iPhone app theme; tinted widgets and Lock Screen widgets follow the system rendering.
• From version 1.0 (41), you can link an Android phone. In the Mac settings, open Android Link and click Show QR, then scan it with the Android app or paste the code. What the Mac sends to Android is encrypted with a key separate from the iPhone one. New QR Code or Unlink changes or ends the link at any time, and Disconnect All also removes what this Mac sent to Android.
• From version 1.0 (40), you can change the order of the menu cards. Drag a row under Menu Card Order in the Mac settings, or right-click a card in the menu and choose Change Order to jump there. Newly connected accounts go to the bottom. The order is kept on this Mac and is separate from the iPhone home card order.
• The Mac app is required to receive actual subscription usage on iPhone. The iPhone companion is free, with no ads or mobile app tiers and optional in-app Mac license purchase, and focuses on usage cards, widgets and alerts. The Mac trial covers one selected account; a valid license unlocks all accounts. The Android app also shows Mac-authorized usage and offers optional Mac license purchase through Google Play. If the Mac is asleep or this app is closed, the iPhone retains the last received readings but does not receive new usage.
• The number next to the menu bar icon is the average of the big numbers on the cards in the menu, with fractions rounded toward less left. A card's big number is that account's weekly limit, or its 5-hour limit if there is no weekly one.
• The gauge and the rocket always show what is left. The rocket circles more slowly as your weekly limits run low. Version 1.0 (33) makes the speed difference between high and low remaining limits more noticeable.
• Codex checks your default account and signed-in accounts in ~/.codex-*, such as ~/.codex-review, separately. To add an account in another location, click Add Account under Codex in the Mac settings and select its Codex settings folder or enter its path. Disconnect stops showing that account without signing it out of Codex. This needs Mac version 1.0 (24) or later; iPhone version 1.0 (23) can already show the accounts.
• Each card shows its plan name in small type, such as Max 20x, Max 5x, Pro Max or Plus. The plan also appears on your iPhone when both apps are version 1.0 (23) or later.
• Limit display, under General in the settings window, shows either what is left (the default, for example 76% left) or what is used (for example 24% used). It changes the numbers and bars on the cards, the number in the menu bar, and the Claude Code status line summary shown when you had no status line of your own.
• On your iPhone, Limit display is a separate setting under Home Screen in the Tokens left? settings. It changes the home cards, the widgets and limit alerts. Changing one does not change the other.
• Once you click Connect Claude Code, Claude Code accounts you add later are connected automatically. An account you disconnect yourself stays disconnected, and Disconnect All turns automatic connection off until you click Connect Claude Code again. Only folders where you have signed in to Claude Code count as accounts, so folders of other tools with similar names, such as ~/.claude-code-router, are left alone. From version 1.0 (40), to add a Claude Code settings folder kept in another location (for example one you use with CLAUDE_CONFIG_DIR), click Add Account under Claude Code in the Mac settings and select the folder or enter its path. Only folders that Claude Code has already used, with a .claude.json file inside, can be added.
• Click the edit icon beside a Claude or Codex account name in the Mac settings to open a small editing popover. Enter the name and click Save or press Return. Cancel or Escape discards the edit. The name is sent encrypted to your iPhone and appears on its home cards and widgets. On iPhone, use Usage Names in Settings or hold a home card and choose Rename. A name set on iPhone overrides the received name only on that iPhone; Use Original Name restores the name received from your Mac. Version 1.0 (30) uses a neutral pencil icon on both apps. From version 1.0 (40), account folders and the codex program appear as a folder icon next to the edit icon instead of a written path. Hover over it to see the path, or click it to open the location in Finder.
• The Mac app uses regular buttons. The settings window uses Liquid Glass on macOS 26 or later and a standard translucent material on earlier versions, with solid ivory or muted navy panels inside. Section headings sit inside the panels. Version 1.0 (44) keeps the system glass background and adds a faint navy and teal gradient behind the settings content. Reduce Transparency removes this decoration and uses an opaque brand background. From version 1.0 (32), the Mac menu uses the same usage card layout as iPhone: large percentages, a gauge, plan badges, and reset information. From version 1.0 (40), the outer surface of the menu is the system popover glass, including the pointed tip at the top, and the cards inside are filled with ivory or navy. Version 1.0 (33) uses smaller cards and a narrower, shorter menu. When you have many accounts, scroll through the card list.
• From version 1.0 (29), Recent Consumption in General offers 1, 2, 4 or 6 hours, with display off by default. The Mac menu shows the approximate share of the full quota consumed as %, based on weekly limits or 5-hour limits when no weekly limit is available. Recording continues while the Mac app runs even with the display off. Enough history and a fresh reading are needed; resets and missing readings show a status. On iPhone version 1.0 (29), its separate setting under Home Screen controls home cards and medium widgets. From version 1.0 (32), recent consumption sits to the right of the large remaining or used percentage, above the gauge, in both the Mac menu and iPhone home cards. The period and value form a two-line group, aligned on the left.
• Disconnect All is in a compact footer at the bottom of the settings window, next to its title and help button.
• In the Mac and iPhone settings, click or tap the question mark button next to a section title to see its explanation.

Remove

Click Disconnect All at the bottom of the settings window, quit Tokens left from the menu bar, and delete it from Applications.

Privacy

Values are sent encrypted, and we do not collect AI credentials, keys, account names, conversations or usage values. The app uses only methods that do not violate the AI services' terms. Details are in the privacy policy.

시작하기 전에

• iPhone과 맥에 같은 Apple 계정으로 로그인하고, 두 기기 모두 암호 동기화를 켜 두세요.
• 맥에서 Claude Code(Pro, Max)나 Codex(ChatGPT 로그인)를 써야 값이 생깁니다.

설치

1. 받은 파일을 열고 Tokens left를 응용 프로그램 폴더로 끌어다 놓습니다.
2. Tokens left를 엽니다. 메뉴 막대에 아이콘이 나타납니다. 로켓이 원을 돌며 남은 양만큼 게이지를 그립니다. 처음 열 때 macOS가 인터넷에서 받은 앱을 열지 묻습니다. '열기'를 누르세요. 처음 열면 설정 창이 먼저 뜹니다.
3. 설정 창에서 'Claude Code 연결'을 누릅니다. 원래 쓰던 Claude Code 상태줄은 그대로 보입니다.
4. '로그인할 때 열기'를 켜 두세요. 맥을 다시 켜도 맥 앱이 저절로 열려 계속 보냅니다. 이때 macOS는 '백그라운드 항목 추가됨' 알림만 띄웁니다.
5. Codex는 따로 켤 것이 없습니다(맥 앱이 5분마다 받음). iPhone의 Tokens left? 설정에서 '구독 한도 보기'를 켜고, '맥 앱: 연결됨'이 보이면 준비된 것입니다. 맥에서는 메뉴 막대 아이콘을 누르면 'iPhone으로 보냄: 시각'이 보입니다. iPhone 앱은 광고와 모바일 앱 등급이 없는 무료 구독 사용량 동반 앱입니다. 앱에서 맥 라이선스를 선택적으로 구매하고 발급된 키를 맥에 등록할 수 있습니다. 실제 사용량을 받으려면 맥 앱이 필요합니다. 맥 앱의 체험은 선택한 계정 하나를 대상으로 하고, 유효한 라이선스로 모든 계정을 사용합니다.

메뉴 막대와 설정

• 1.0 (46)부터 맥 설정의 일반 > 테마에서 시스템 설정, 라이트, 다크 중에 고릅니다. iPhone은 설정 > 홈 화면 > 테마에서 따로 고릅니다. 선택은 기기마다 저장됩니다. 일반 홈 화면 위젯은 iPhone 앱 테마를 따르고, 틴트 위젯과 잠금 화면 위젯은 시스템 표시 방식을 따릅니다.
• 1.0 (41)부터 안드로이드 폰과 연결할 수 있습니다. 맥 설정의 '안드로이드 연결'에서 'QR 보기'를 누른 뒤 안드로이드 앱으로 찍거나 코드를 붙여 넣으세요. 안드로이드로 보내는 값은 iPhone과 다른 키로 암호화합니다. '새 QR로 바꾸기'나 '연결 끊기'로 언제든 바꾸거나 끊을 수 있고, '모두 해제'를 누르면 이 맥이 안드로이드로 보낸 값도 지웁니다.
• 1.0 (40)부터 메뉴 카드 순서를 바꿀 수 있습니다. 맥 설정의 '메뉴 카드 순서'에서 줄을 끌어 옮기거나, 메뉴 창의 카드를 오른쪽 클릭해 '순서 바꾸기'를 누르면 그 설정으로 갑니다. 새로 연결한 계정은 맨 아래에 붙습니다. 이 순서는 이 맥에만 저장되며 iPhone 홈 카드 순서와는 따로입니다.
• iPhone에서 실제 구독 사용량을 받으려면 맥 앱이 필요합니다. iPhone은 광고와 모바일 앱 등급이 없는 무료 동반 앱으로, 앱에서 맥 라이선스를 선택적으로 구매할 수 있으며 사용량 카드와 위젯, 알림에 집중합니다. 맥 앱의 체험은 선택한 계정 하나를 대상으로 하며 유효한 라이선스로 모든 계정을 사용합니다. Android 앱도 맥에서 허용한 사용량을 표시하며 Google Play에서 맥 라이선스를 선택적으로 구매할 수 있습니다. 맥이 잠자거나 이 앱을 닫으면 iPhone의 마지막 값은 남지만 새 사용량은 오지 않습니다.
• 메뉴 막대 아이콘 옆 숫자는 메뉴 창 카드에 있는 큰 숫자들의 평균입니다. 소수점 아래는 남은 양이 적게 보이는 쪽으로 맞춥니다. 카드의 큰 숫자는 계정마다 주간 한도이고, 주간 한도가 없으면 5시간 한도입니다.
• 게이지와 로켓은 늘 남은 양을 나타냅니다. 주간 한도가 적게 남을수록 로켓이 더 천천히 돕니다. 1.0 (33)에서는 남은 한도에 따른 회전 속도 차이를 더 크게 조정했습니다.
• Codex는 기본 계정과 ~/.codex-review 같은 ~/.codex-*의 로그인된 계정을 각각 조회합니다. 다른 곳에 둔 계정은 맥 설정의 Codex에서 '계정 추가'를 누르고 Codex 설정 폴더를 고르거나 경로를 입력하면 됩니다. '해제'는 표시만 멈추고 Codex 로그인은 유지합니다. 맥 앱은 1.0 (24) 이상이 필요하고, iPhone은 기존 1.0 (23)에서도 여러 계정을 보여 줍니다.
• 카드에는 요금제 이름(Max 20배, Max 5배, Pro Max, Plus 등)이 작게 보입니다. 맥 앱과 iPhone 앱이 모두 1.0 (23) 이상이면 iPhone에도 요금제가 보입니다.
• 설정 창 '일반'의 '한도 표시'에서 남은 양(기본, 예: 76% 남음)과 사용량(예: 24% 사용) 중에 고릅니다. 메뉴 창 카드의 숫자와 막대, 메뉴 막대 숫자, Claude Code 상태줄 요약(원래 쓰던 상태줄이 없을 때 보이는 것)이 따라 바뀝니다.
• iPhone은 Tokens left? 설정의 '홈 화면'에 있는 '한도 표시'에서 따로 고릅니다. 홈 카드와 위젯, 한도 알림 문구가 따라 바뀝니다. 한쪽을 바꿔도 다른 쪽은 그대로입니다.
• 'Claude Code 연결'을 한 번 누르면 나중에 생긴 Claude Code 계정도 알아서 연결합니다. 직접 '해제'한 계정은 다시 연결하지 않고, '모두 해제'를 누르면 자동 연결도 꺼집니다('Claude Code 연결'을 다시 누르면 켜집니다). Claude Code에 로그인한 적이 있는 폴더만 계정으로 보고, 이름만 비슷한 다른 도구의 폴더(~/.claude-code-router 등)는 건드리지 않습니다. 1.0 (40)부터 다른 곳에 둔 Claude Code 설정 폴더(CLAUDE_CONFIG_DIR로 쓰는 폴더 등)는 맥 설정의 Claude Code에서 '계정 추가'를 누르고 폴더를 고르거나 경로를 입력하면 됩니다. Claude Code를 실행한 적이 있어 .claude.json 파일이 있는 폴더만 추가할 수 있습니다.
• 맥 설정의 Claude나 Codex 계정 이름 옆 편집 아이콘을 누르면 작은 편집 팝오버가 열립니다. 이름을 입력하고 '저장'이나 Return을 누르세요. '취소'나 Escape를 누르면 변경하지 않고 닫습니다. 이름은 암호화해서 iPhone으로 보내며 홈 카드와 위젯에도 보입니다. iPhone에서는 설정의 '사용량 이름'이나 홈 카드를 길게 눌러 '이름 바꾸기'를 쓰세요. iPhone에서 정한 이름은 그 iPhone에서만 우선하며, '원래 이름 사용'을 누르면 맥에서 받은 이름으로 돌아갑니다. 1.0 (30)에서는 두 앱 모두 테마에 맞는 중립색 연필 아이콘을 씁니다. 1.0 (40)부터 계정 폴더와 codex 프로그램의 경로는 글자 대신 편집 아이콘 옆 폴더 아이콘으로 보입니다. 마우스를 올리면 경로가 보이고, 누르면 Finder에서 그 위치를 엽니다.
• 맥 앱은 일반 버튼을 씁니다. 설정 창은 macOS 26 이상에서 Liquid Glass, 이전 버전에서는 기본 반투명 재질을 쓰며 안쪽 패널을 아이보리나 차분한 남색으로 채웁니다. 구역 제목은 패널 안에 둡니다. 1.0 (44)에서는 시스템 유리 배경을 유지하며 설정 내용 뒤에 옅은 남색과 청록 그라데이션을 더했습니다. '투명도 줄이기'를 켜면 이 장식을 없애고 불투명 브랜드 배경을 씁니다. 1.0 (32)부터 맥 메뉴는 iPhone과 같은 사용량 카드 구성(큰 퍼센트, 게이지, 요금제, 초기화 안내)을 씁니다. 1.0 (40)부터 메뉴 창 바깥은 위쪽의 뾰족한 부분까지 시스템 팝오버 유리이고, 안쪽 카드는 아이보리나 남색으로 채웁니다. 1.0 (33)에서는 카드와 메뉴 창을 더 작게 조정했습니다. 계정이 많으면 카드 목록을 스크롤해 볼 수 있습니다.
• 1.0 (29)부터 '일반'의 '최근 소모량'에서 최근 1시간, 2시간, 4시간, 6시간을 고를 수 있습니다. 기본은 표시 안 함입니다. 맥 메뉴에는 주간 한도 전체에서 소모한 비율(%)의 근삿값이 보이며, 주간 한도가 없으면 5시간 한도를 기준으로 합니다. 맥 앱이 실행 중이면 표시를 꺼도 기록합니다. 충분한 기록과 새 수신값이 필요하고, 초기화나 기록 부족은 상태로 표시합니다. iPhone 1.0 (29)에서는 '홈 화면'의 별도 설정으로 홈 카드와 중간 크기 위젯에 표시합니다. 1.0 (32)부터 맥 메뉴와 iPhone 홈 카드의 최근 소모량은 게이지 위 큰 남은 양이나 사용량 오른쪽에 표시합니다. 기간과 값을 두 줄로 모아 왼쪽에 붙여 보여 줍니다.
• 설정 맨 아래의 '모두 해제'는 제목과 도움말 옆에 간결하게 배치했습니다.
• 맥과 iPhone 설정의 설명은 구역 제목 옆 물음표 버튼을 누르면 보입니다.

제거

설정 창 맨 아래 '모두 해제'를 누른 뒤, 메뉴 막대에서 종료하고 응용 프로그램 폴더에서 지우세요.

개인정보

값은 암호화해서 보내고, 개발자는 AI 로그인 정보, 키, 계정 이름, 대화 내용과 사용량 수치를 수집하지 않습니다. AI 서비스의 약관을 어기지 않는 방식만 씁니다. 자세한 내용은 개인정보 처리방침에 있습니다.