面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/coding-plan-personal-ark-cli.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

Ark CLI:Coding Plan 个人版使用指南

Ark CLI 是火山方舟平台官方命令行工具,可在本地终端快捷配置与管理 Coding Plan 个人版的套餐和模型。

一、安装和登录 ArkCLI#

环境要求: Node.js >= 16

安装 Ark CLI#

在终端执行以下命令:

Bash
# 1. 通过 NPM 安装(下载最新版本)
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

登录 Ark CLI#

Bash
# 登录方式
arkcli auth login

# 查看登录状态
arkcli auth status

将下方提示词复制给 AI Agent(Claude Code、Codex、Cursor、Trae 等),它会自动完成安装。

Plain
根据下面命令帮我安装 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?是什么规格?"
  • 新购套餐:

    Bash
    # 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
    
  • 续费:

    Bash
    # 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
    
  • 查询账号下套餐状态:

    Bash
    arkcli plans get
    

配置#

功能 示例提示词
查询套餐支持的模型 "Coding Plan Pro 支持哪些模型?"

用量#

功能 示例提示词
余额查询 "我这个月 Coding Plan 还剩多少额度?"
用量查询 "我五小时额度还剩多少?"
Model 用量查询 "我本周 doubao-seed-2.1-lite 用了多少额度?"