Ark CLI 是火山方舟平台官方命令行工具,可在本地终端快捷配置与管理 Coding Plan 个人版的套餐和模型。
一、安装和登录 ArkCLI#
环境要求: Node.js >= 16
安装 Ark CLI#
在终端执行以下命令:
# 1. 通过 NPM 安装(下载最新版本)
npm install -g @volcengine/ark-cli@latest
# 2. 验证安装
arkcli --version
登录 Ark CLI#
# 登录方式
arkcli auth login
# 查看登录状态
arkcli auth status
将下方提示词复制给 AI Agent(Claude Code、Codex、Cursor、Trae 等),它会自动完成安装。
根据下面命令帮我安装 Ark CLI:https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/intro/volc.md
二、配置 Coding Plan#
目前支持 Claude Code、Codex、OpenCode、OpenClaw、Trae 等主流工具,更多 Agent 陆续支持中。
在终端中输入命令 arkcli helper,根据 TUI 交互引导配置套餐、模型。
现以Coding plan个人版配置Claude Code为例:
三、使用 ArkCLI#
能力概览#
ArkCLI 支持 Coding Plan 相关命令,覆盖交易、配置、用量三大范围,更多能力见 ArkCLI 指南。
- 交易:新购、续费、查询账号下套餐状态
- 配置:配置模型、查询套餐支持模型、查询配置状态
- 用量:余额查询、用量查询
交易#
| 功能 | 示例提示词 |
|---|---|
| 新购套餐 | "我想买一个 Coding Plan 个人版 Pro,帮我下单" |
| 续费套餐 | "帮我续费一个月 Coding Plan" |
| 查询账号下套餐状态 | "我都订阅了哪些 Plan?是什么规格?" |
-
新购套餐:
# arkcli plans buy --plan <套餐名> --type <规格> [--duration <月数>] [--yes] # 参数说明: # 套餐名:coding-plan # 规格:lite/pro # 月数:1-12 月,例如:1,若不传该参数,默认 1 个月 # --yes:真实下单确认,若没有 --yes 仅返回订单预览与协议,建议先不加 --yes,预览订单 # 示例命令: # 预览:只返回协议链接 arkcli plans buy --plan coding-plan --type pro --duration 1 # 真实下单 arkcli plans buy --plan coding-plan --type pro --duration 1 --yes -
续费:
# arkcli plans renew --plan <套餐名> [--duration <月数>] [--yes] # 参数说明: # 套餐名:coding-plan # 月数:1-12 月,例如:1,若不传该参数,默认 1 个月 # --yes:真实下单确认,若没有 --yes 仅返回订单预览与协议,建议先不加 --yes,预览订单 # 示例命令: # 预览:只返回协议链接 arkcli plans renew --plan coding-plan --duration 1 # 真实下单 arkcli plans renew --plan coding-plan --duration 1 --yes -
查询账号下套餐状态:
arkcli plans get
配置#
| 功能 | 示例提示词 |
|---|---|
| 查询套餐支持的模型 | "Coding Plan Pro 支持哪些模型?" |
用量#
| 功能 | 示例提示词 |
|---|---|
| 余额查询 | "我这个月 Coding Plan 还剩多少额度?" |
| 用量查询 | "我五小时额度还剩多少?" |
| Model 用量查询 | "我本周 doubao-seed-2.1-lite 用了多少额度?" |