1. 前提条件
在开始配置之前,请确保您已经完成以下准备工作:
- ✅已完成 Claude Code 接入 DeepSeek
- ✅Claude Code 已正确安装并可以正常使用
- ✅拥有有效的 DeepSeek API Key
- 注意:不能使用ccswitch代理,必须是API直连claude code
2. 配置步骤
2.1 启动 Claude Code 会话
首先,在您的终端或命令行工具中启动 Claude Code:
claude2.2 添加插件仓库
在 Claude Code 会话中,执行以下命令添加 deepseek-hud 插件仓库:
/plugin marketplaceaddTang-Annan/deepseek-hud2.3 安装插件
继续执行插件安装命令:
/plugininstalldeepseek-hud安装选项说明:
- 选择【Install for you(user scope)】(为用户安装)
- 不要选择 workspace 或 global 范围,除非您有特殊需求
2.4 确认配置修改
安装过程中,系统会提示您修改settings.json文件:
提示:需要修改 settings.json 以启用插件,是否确认? [Yes/No]请选择Yes确认修改。
2.5 配置 API Key
安装完成后,配置您的 DeepSeek API Key:
/deepseek-hud:setup按照提示输入您的 DeepSeek API Key。
2.6 重启 Claude Code
完成配置后,退出当前会话:
/exit然后重新启动 Claude Code:
claude3. 验证配置
重启后,您应该能在 Claude Code 界面底部看到DeepSeek 余额状态栏,显示以下信息:
- 🔋账户余额
- 📊Token 消耗统计
- ⏰最后更新时间
4. 常用指令
4.1 手动刷新余额
如果需要立即刷新余额信息,可以使用:
/deepseek-hud:refresh4.2 重新设置 API Key
如果需要更换或重新设置 API Key:
/deepseek-hud:setup4.3 其他管理命令
# 查看插件信息/plugin info deepseek-hud# 禁用插件/plugin disable deepseek-hud# 启用插件/pluginenabledeepseek-hud5. 注意事项
5.1 数据更新频率
- 🔄自动轮询:插件每 30 秒自动拉取一次余额信息
- ⏳平台延迟:DeepSeek 平台数据存在最多 5 分钟延迟
- 📋最终参考:最终账单以 DeepSeek 官网控制台为准
5.2 常见问题
状态栏不显示
- 确认插件已正确安装
- 检查 API Key 配置是否正确
- 尝试重启 Claude Code
余额显示为 0 或错误
- 确认 API Key 有足够余额
- 使用
/deepseek-hud:refresh手动刷新 - 检查网络连接
插件安装失败
- 确认网络可以访问 GitHub
- 检查 Claude Code 版本是否兼容
6. 使用技巧
6.1 监控使用情况
通过状态栏可以实时监控:
- 当前会话的 Token 消耗
- 剩余可用额度
- 使用趋势预估
6.2 成本控制建议
- 设置使用提醒:当余额低于阈值时及时充值
- 定期检查:每天查看使用情况
- 优化提示词:减少不必要的 Token 消耗
7. 总结
deepseek-hud 插件为 Claude Code 用户提供了便捷的 DeepSeek 余额监控功能,通过简单的配置步骤即可实现:
- ✅ 添加插件仓库
- ✅ 安装插件
- ✅ 配置 API Key
- ✅ 重启生效
状态栏的实时显示让您在使用 Claude Code 时能够更好地控制成本,避免因余额不足而中断工作流程。
温馨提示:虽然插件提供了方便的余额监控,但建议定期登录 DeepSeek 官网核对详细账单,确保数据的准确性。