Token Meter의 Claude Code에 로그인, 키체인 접근 허용, Claude Code 받기 버튼은 이 페이지에 설명된 작업을 클릭 한 번으로 대신 수행할 뿐입니다. 직접 진행하려면 아래 단계를 따르세요.
Token Meter는 Claude 자격 증명을 자체적으로 새로 고치지 않습니다. 토큰을 교체하면 Claude Code의 기존 세션이 중단되기 때문입니다. Anthropic에 사용량을 조회할 때만 자격 증명을 한 번 읽습니다.
1. Claude Code 설치 확인
command -v claude
경로가 표시되면 Claude Code가 설치되어 있습니다. 아무것도 표시되지 않으면 https://claude.com/claude-code에서 설치하세요.
CLI가 PATH에 없어도 Token Meter는 토큰 수를 집계할 수 있습니다. ~/.claude/projects의 로그만 읽기 때문입니다. claude 명령은 이 단계에 따라 다시 로그인할 때만 필요합니다.
2. 다시 로그인
터미널에서 다음 명령을 실행합니다.
claude
실행된 후 REPL 안에서 다음을 입력합니다.
/login
열린 브라우저에서 로그인을 완료하세요. /login은 CLI 플래그가 아니라 대화형 REPL 안에서 사용하는 슬래시 명령이므로 Token Meter를 비롯한 외부 도구가 사용자 조작 없이 완료할 수 없습니다.
로그인이 끝나면 Token Meter에서 다시 확인을 클릭하세요.
3. 키체인 접근 허용
Claude Pro / Max의 남은 사용량을 표시하려면 Token Meter가 Claude Code가 macOS 키체인에 저장한 Claude Code-credentials 항목을 읽어야 합니다.
처음 읽을 때 macOS가 다음과 비슷한 대화상자를 표시합니다.
"Token Meter" wants to use your confidential information stored in "Claude Code-credentials" in your keychain.
- **항상 허용(Always Allow)**을 선택하면 이후 새로 고침에서는 다시 묻지 않습니다.
- **허용(Allow)**을 선택하면 한 번만 허용되며 다음 새로 고침 때 다시 묻습니다.
- **거부(Deny)**를 선택하면 접근이 거부되며, 이후에는 아래의 “거부를 선택한 경우” 단계를 따라야 합니다.
Token Meter의 키체인 접근 허용 버튼은 필요할 때 이 읽기를 한 번 실행합니다. 따라서 백그라운드 새로 고침 중이 아니라 버튼을 클릭한 직후 대화상자가 표시됩니다.
거부를 선택한 경우
macOS는 키체인 항목별로 거부 설정을 기억하므로 Token Meter에서 되돌릴 수 없습니다. 키체인 접근에서 권한을 변경하세요.
- 키체인 접근을 엽니다. Spotlight에서 “키체인 접근” 또는 “Keychain Access”를 검색하세요. macOS 버전에 따라 앱은
/System/Applications/Utilities/또는/System/Library/CoreServices/Applications/에 있습니다. Claude Code-credentials를 검색해 엽니다.- 접근 제어 탭에서 Token Meter를 허용합니다. 또는 목록에서 Token Meter를 제거하여 다음에 macOS가 다시 묻게 할 수 있습니다.
- Token Meter로 돌아가 다시 확인을 클릭합니다.
Claude 사용량을 표시하지 않으려면 설정에서 Claude Pro / Max 사용량을 끄세요. 키체인 읽기와 네트워크 접근은 중지되며, 로컬 로그를 사용한 토큰 수 집계는 계속 작동합니다.
4. 문제 해결
| 증상 | 확인할 내용 |
|---|---|
| “로그인이 만료되었습니다”가 사라지지 않음 | claude를 실행하고 /login을 다시 진행한 다음 완료 후 다시 확인을 클릭하세요. |
command not found: claude |
설치 경로가 PATH에 없습니다. .zprofile과 .zshrc를 확인하세요. |
| 대화상자 없이 접근이 거부됨 | 위의 “거부를 선택한 경우” 단계를 따르세요. |
| 다시 서명된 빌드로 앱을 교체함 | macOS가 다른 바이너리로 인식하므로 키체인 접근을 다시 허용해야 합니다. |