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 是交互式 REPL 内的斜杠命令,而不是 CLI 参数,因此 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)”,只会授权一次,下次刷新时 macOS 会再次询问。
- 选择“拒绝(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 会将其视为不同的二进制文件,因此需要重新授予钥匙串访问权限。 |