返回 Token Meter设置指南

Claude Code 登录与钥匙串访问.

Token Meter 的 Claude 集成所需的登录与钥匙串授权步骤。

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 无法自行撤销。请在“钥匙串访问”中更改权限:

  1. 打开“钥匙串访问”。可使用 Spotlight 搜索“钥匙串访问”或“Keychain Access”。根据 macOS 版本,该应用位于 /System/Applications/Utilities//System/Library/CoreServices/Applications/
  2. 搜索并打开 Claude Code-credentials
  3. 在“访问控制”标签页中允许 Token Meter。也可以从列表中移除 Token Meter,让 macOS 下次再次询问。
  4. 返回 Token Meter,点击“重新检查”。

如果不想显示 Claude 用量,请在设置中关闭“Claude Pro / Max 用量”。钥匙串读取和网络访问将停止,而基于本地日志的令牌统计仍可继续使用。

4. 故障排除

症状 检查方法
“登录已过期”提示一直不消失 启动 claude,再次运行 /login,完成后点击“重新检查”。
command not found: claude 安装位置不在 PATH 中。请检查 .zprofile.zshrc
没有显示对话框就被拒绝访问 按照上面的“如果误选了拒绝”步骤操作。
已将应用替换为重新签名的版本 macOS 会将其视为不同的二进制文件,因此需要重新授予钥匙串访问权限。