Axis Api

Appearance

AxisAPI Statusline ​

在 Claude Code 状态栏中显示 Axis Api 余额、今日用量、渠道、模型和上下文使用率

@axisapi/statusline 是为 Axis Api 用户准备的 Claude Code 状态栏工具。它可以自动检测本地 Axis Api Provider 配置，并写入 Claude Code 的 statusLine 配置。

功能特性 ​

  • 自动从环境变量、Claude Code settings、CC Switch JSON 文件和 CC Switch SQLite 数据中检测 Axis Api Provider
  • 初始化时自动写入 Claude Code statusLine.command = "axisapi-statusline"
  • 在状态栏中显示余额、今日用量、渠道/Provider、模型和上下文使用率
  • 本地缓存成功的 API 响应，请求失败时回退到旧缓存
  • 提供 doctor、sync、config、clear-cache 等命令，方便安装、同步和排查问题

环境要求 ​

  • Node.js 18+
  • Claude Code
  • Axis Api Provider / API Key（会自动读取本机 CC Switch 配置；如果没有使用 CC Switch，也可以手动传入）

安装 ​

通过 npm 全局安装：

bash
npm install -g @axisapi/statusline

快速开始 ​

初始化状态栏：

bash
axisapi-statusline init

初始化命令会自动检测 Axis Api 配置，并写入 Claude Code 的 statusLine 配置。

如果自动检测失败，可以手动传入 Provider 信息：

bash
axisapi-statusline init --base-url https://axisapi.cn --api-key sk-axis-xxxx --model gpt-5.5

初始化完成后，重启 Claude Code。之后 Claude Code 渲染状态栏时会自动调用 axisapi-statusline。

TIP

如果你已经用 CC Switch 配置过 Axis Api，通常可以直接运行 axisapi-statusline init，让工具自动检测本地配置。

WARNING

请妥善保管 API Key，不要把真实 Key 粘贴到公开仓库、截图或聊天记录中。

常用命令 ​

bash
axisapi-statusline          # 渲染状态栏，Claude Code 会调用这个命令
axisapi-statusline init     # 初始化本地配置并写入 Claude Code statusLine
axisapi-statusline sync     # 从环境变量 / Claude settings / CC Switch 重新同步 Provider
axisapi-statusline doctor   # 检查配置、statusLine 写入情况和 API 连通性
axisapi-statusline config   # 查看本地配置，API Key 会被脱敏
axisapi-statusline clear-cache # 清理本地缓存，下次渲染状态栏时重新请求最新数据

效果预览 ​

完整状态栏 ​

text
AxisAPI ¥23.80 · 今日 ¥1.24 · Claude-A · Sonnet 4.5 · 32%
字段含义
AxisAPI后端返回的平台名称，或本地配置中的平台名称
¥23.80当前账户余额，会根据后端返回的币种格式化
今日 ¥1.24今日用量/消费
Claude-A后端返回的当前渠道或 Provider
Sonnet 4.5后端返回的模型显示名，或 Claude Code 检测到的模型
32%Claude Code 上下文窗口使用率

API 不可用但存在缓存 ​

text
AxisAPI ¥23.80 · 今日 ¥1.24 · Claude-A · Sonnet 4.5 · 32%

如果实时 API 请求失败，但之前存在成功响应缓存，状态栏会回退到旧缓存数据，仍然显示上一次可用的余额、用量、渠道和模型信息。

已初始化但没有 API 数据 ​

text
AxisAPI · Sonnet 4.5 · 32%

当本地 Axis Api 配置存在，但实时 API 数据和缓存 API 数据都不可用时，会显示基础状态栏信息。

通过本地 CC Switch 代理运行 ​

text
AxisAPI · Sonnet 4.5 · 32% · via CCSwitch

当 ANTHROPIC_BASE_URL 指向本地代理，并且没有实时/缓存 API 数据时，会显示 via CCSwitch。

尚未初始化 ​

text
AxisAPI · Sonnet 4.5 · 32% · 未初始化

出现 未初始化 时，需要先运行 axisapi-statusline init。

排查问题 ​

状态栏显示“未初始化” ​

运行初始化命令：

bash
axisapi-statusline init

如果仍然失败，手动传入 Provider 信息：

bash
axisapi-statusline init --base-url https://axisapi.cn --api-key sk-axis-xxxx

状态栏没有余额或今日用量 ​

先运行诊断命令：

bash
axisapi-statusline doctor

常见原因包括：

  • API Key 不可用或已失效
  • 本地配置没有同步到最新 Provider
  • 网络无法访问 Axis Api
  • 后端状态栏接口暂时不可用

可以重新同步 Provider：

bash
axisapi-statusline sync

想查看当前配置 ​

bash
axisapi-statusline config

该命令会对 API Key 做脱敏处理，适合用于排查配置是否正确。

想清理缓存 ​

bash
axisapi-statusline clear-cache

清理后，状态栏会在下次渲染时重新请求最新数据。

INFO

axisapi-statusline 是 Claude Code 的状态栏增强工具。如果你还没有配置 Claude Code 连接 Axis Api，请先查看 Claude Code 配置指南。