К основному содержанию
скилл CX Codex

volcengine-cli — скилл для Claude Code: что делает и как установить

Скилл volcengine-cli для Claude Code и Codex управляет ресурсами облака Volcengine через консольную утилиту ve. Помогает разворачивать серверы ECS, настраивать сети VPC и запускать модели Ark.

MIT 1 300 установок ★ 37 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-cli -a claude-code
Открыть на GitHub

Что делает volcengine-cli

Скилл выполняет вызовы к облачной инфраструктуре Volcengine через интерфейс командной строки ve. Он автоматизирует операции со службами ECS, VPC, балансировщиками CLB, базами данных RDS и инстансами Redis. Запросы к объектному хранилищу TOS перенаправляются в ve tosutil, поиск по логам TLS идёт через ve volclog, а работа с ML-моделями и эндпоинтами — через ve arkcli.

Перед выполнением команд агент подставляет метаданные вызова: переменные окружения VE_CALLER_TYPE, VE_CALLER_NAME и VE_SKILL_NAME. Работоспособность проверяется командой ve sts GetCallerIdentity. Правила безопасности запрещают читать конфигурационный файл ~/.volcengine/config.json и выводить секреты в логи или терминал.

Для работы требуются установленные бинарники ve и npx. Если утилита ve отсутствует, она устанавливается из пакета @volcengine/cli.

Какие задачи решает

  • создать и настроить виртуальные серверы ECS
  • развернуть сетевую инфраструктуру VPC и группы безопасности
  • управлять хранилищем TOS через интерфейс ve tosutil
  • запускать модели машинного обучения в Ark через ve arkcli

Примеры запросов агенту

  • Выведи список моих виртуальных машин ECS в формате JSON через ve
  • Создай новую подсеть в существующем VPC на Volcengine
  • Проверь авторизацию в облаке с помощью ve sts GetCallerIdentity

Как установить volcengine-cli

1Через Skills CLI (Vercel)

npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-cli -a claude-code

2Вручную: положить файлы

~/.claude/skills/volcengine-cli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/volcengine-cli/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о volcengine-cli

Как установить volcengine-cli в Claude Code?

Выполните команду npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-cli -a claude-code.

Что делает скилл volcengine-cli?

Он даёт ИИ-агенту инструкции для управления облачными сервисами Volcengine через CLI, маршрутизируя задачи между ECS, VPC, TOS, TLS и платформой моделей Ark.

Что нужно для работы volcengine-cli?

Нужны бинарные файлы ve и npx, а также настроенные учётные данные доступа к Volcengine.

Исходный текст

SKILL.md · MIT
---
name: volcengine-cli
description: >-
  Create and manage Volcengine cloud resources using the Volcengine CLI (`ve` command). Supports all
  Volcengine services including ECS, VPC, CLB, RDS, Redis, and more. Trigger this skill whenever the
  user asks to create, query, modify, or delete cloud resources on Volcengine, mentions the `ve` command,
  says "volcengine CLI", or describes infrastructure tasks such as "create an ECS instance",
  "set up a VPC", "list security groups", "allocate an EIP". Also trigger on Chinese prompts
  mentioning "火山引擎" or "火山" (e.g., "火山引擎上有哪些 ECS"、"查一下我火山的云服务器"、
  "火山引擎创建一个 VPC"、"火山的 Redis 实例列一下"). Also trigger when the user encounters
  errors from `ve` commands and needs troubleshooting help. Also use for TOS bucket/object operations,
  tosutil (sometimes written tosutils), Ark CLI / arkcli model discovery, inference, generation,
  endpoints, fine-tuning, plans, or usage, and TLS (日志服务) / volclog log search, analysis, ingest,
  export, or LogCollector collection, through `ve tosutil`, `ve arkcli` and `ve volclog`.
license: MIT
metadata:
  openclaw:
    requires:
      bins:
        - ve
        - npx
      env:
        - VE_CALLER_TYPE
        - VE_CALLER_NAME
        - VE_SKILL_NAME
    install:
      - kind: node
        package: "@volcengine/cli"
        bins: [ve]
    envVars:
      - name: VE_CALLER_TYPE
        required: true
      - name: VE_CALLER_NAME
        required: true
      - name: VE_SKILL_NAME
        required: true
      - name: VOLCENGINE_ACCESS_KEY
        required: false
      - name: VOLCENGINE_SECRET_KEY
        required: false
      - name: VOLCENGINE_SESSION_TOKEN
        required: false
      - name: VOLCENGINE_REGION
        required: false
      - name: VOLCENGINE_ENDPOINT
        required: false
      - name: VOLCENGINE_PROFILE
        required: false
      - name: VOLCSTACK_PROFILE
        required: false
      - name: VOLCENGINE_CLI_CONFIG_FILE
        required: false
      - name: VOLCENGINE_LOGIN_CACHE_DIRECTORY
        required: false
      - name: VOLCENGINE_CLI_DOWNLOAD_BASE_URL
        required: false
      - name: VOLCENGINE_CLI_SKIP_SKILLS
        required: false
      - name: VE_VERSION
        required: false
      - name: VE_INSTALL_DIR
        required: false
      - name: VE_LOGIN_URL_TIMEOUT
        required: false
---

# Volcengine CLI Skill

## Credential safety (mandatory)

`ve` finds its credentials by itself. You never need to see them, in whole or in part.

- **Never print or dump environment variables**: no `env`, `printenv`, `set`, `export -p`, `declare -x`, `echo $VOLCENGINE_*`, no reading `/proc/*/environ`. "Pre-flight" and "environment" checks are no exception.
- **Never read `~/.volcengine/config.json`** or other credential/login-cache files.
- **No self-made redaction**: do not pipe the above through `sed`, `grep`, `grep -v`, `awk` or `cut` to mask values, and do not print a prefix, suffix or length of a secret. Such filters are easy to get wrong and leak it.
- **The only credential check is `ve sts GetCallerIdentity`.** Success = usable. Failure = follow [references/auth.md](references/auth.md); do not inspect or edit the credentials to debug it.
- Never put an AccessKey, SecretKey or session token in a reply, file or log.

## Agent caller metadata (mandatory)

Prefix **every** `ve` execution (help, version, login, API calls, retries, polling, product CLIs) and every `scripts/` helper with three variables:

```text
VE_CALLER_TYPE=ai_agent VE_CALLER_NAME="<agent-id>" VE_SKILL_NAME="<current-volcengine-skill>" \
  ve ecs DescribeInstances --output json
```

| Variable | Value |
| --- | --- |
| `VE_CALLER_TYPE` | Always `ai_agent`. |
| `VE_CALLER_NAME` | Your own Agent product name, such as `codex` or `claude-code`. You already know which Agent you are: write it directly, and do not look at environment variables or host information to find it. It names the Agent application, not a model, account or user. |
| `VE_SKILL_NAME` | The frontmatter `name` of the Volcengine skill whose workflow runs the command; `volcengine-cli` when this skill owns it. |

- Write the values yourself; never pass the placeholders or copy another Agent's name.
- A tool call may start a fresh shell: repeat the prefix every time. In pipelines and `$(...)` it must reach the `ve` process itself.
- These are assignments, not flags or request fields. Never add `VOLCENGINE_SAFETY_*` here.
- `ve arkcli`: these three only, no `ARKCLI_*` variables. More cases: [references/env-vars.md](references/env-vars.md).

**Next: `Product CLI routing` and `Native OpenAPI essentials`.** If you cannot see both headings below, your tool cut them out; before your first `ve` call run:

```text
sed -n '/^## Product CLI routing/,/^## References/p' <path-of-this-SKILL.md>
```

## Product CLI routing

| Task | Entry point | Read before use |
| --- | --- | --- |
| Cloud resource OpenAPIs | `ve <service> <Action>` | [locate-api.md](references/locate-api.md), [execute-api.md](references/execute-api.md) |
| TOS buckets, objects and transfers | `ve tosutil <command>` | [product-cli.md](references/product-cli.md), then skill `volcengine-tosutil` |
| Ark models, inference, generation, endpoints, fine-tuning, plans, usage | `ve arkcli <command>` | [product-cli.md](references/product-cli.md), then the official Ark skills |
| TLS (日志服务) search, analysis, ingest, export, LogCollector | `ve volclog <command>` | [product-cli.md](references/product-cli.md), then `volcengine-tls` / `volcengine-tls-logcollector` |

- Prefer the `ve` proxy even when a standalone `tosutil`, `arkcli` or `volclog` is installed. `ve` installs a missing child on first use.
- Replace only the executable prefix of the product skill's examples (`tosutil ...` → `ve tosutil ...`); keep every later argument. Child flags go after the child command.
- Delegated CLIs keep their own authentication, profiles, flags, output and confirmation rules. Native rules (`--output`, `--query`, `--force`, `--DryRun`, the safety policy and its `--yes` retry) do not carry over, and a working `ve sts GetCallerIdentity` does not prove the child is authenticated.
- `ve` has no native `tls` service: never use `--force` for TLS; an unknown-service answer from `ve volclog` means `ve` is too old.

## Native OpenAPI essentials

Details and examples: [locate-api.md](references/locate-api.md) and [execute-api.md](references/execute-api.md).

- **Find the API**: `ve <service> 2>&1 | grep -i <keyword>` for the Action, `ve 2>&1 | grep -i <keyword>` for the service, then `python3 scripts/find_api.py <keyword>`. A non-default API version is a separate command (`iam` v2021-08-01 → `iam20210801`).
- **Parameters**: `ve <svc> <Action> --help`; add `--detail` for write/destructive actions or after `Invalid*` / `Missing*` errors. Never guess parameter names.
- **Shape**: API parameters are PascalCase (`--InstanceIds.1 i-xxx`, `--Tags.1.Key k`), system flags are lowercase and follow the Action (`--region`, `--profile`, `--output`, `--query`). When `--help` shows only `--body`, pass one JSON body: `--body '{...}'`.
- **Output**: keep the default `json` for your own reading; `--query '<JMESPath from Result.>'` with `--output text` to capture IDs, `--output table` to show lists to the user. Do not use `--output off` on `Create*` / `Run*` / `Allocate*`.
- **API missing from the CLI metadata** (`unknown service` / `unknown action`): `--force` with `--version` (and `--endpoint` for an unknown service); recipes in [extend-apis.md](references/extend-apis.md).
- **Async resources**: poll the `Describe*` call with a deadline until the target status; take status names from `--help --detail` and the service note.
- **DryRun**: a successful `--DryRun true` exits 1 with `DryRunOperation` in stderr; that is the pass signal.

## References

If the text above this heading shows a `truncated` marker, the two sections before it were cut: run `sed -n '/^## Product CLI routing/,/^## References/p'` on this file. Then read the reference for your step.

- Install / upgrade `ve`: [install.md](references/install.md)
- Credentials, profiles, login: [auth.md](references/auth.md); Console Login procedure: [console-login.md](references/console-login.md)
- Confirmation modes, safety policy, DryRun: [safety.md](references/safety.md)
- Find the API, parameters, `--force`: [locate-api.md](references/locate-api.md); `--force` recipes: [extend-apis.md](references/extend-apis.md), [extend-api-params.md](references/extend-api-params.md); query+body helper: [extend-api-helper.md](references/extend-api-helper.md)
- System flags, parameters, `--output` / `--query`, polling: [execute-api.md](references/execute-api.md)
- Product CLIs: [product-cli.md](references/product-cli.md); errors: [common-errors.md](references/common-errors.md)
- Service notes: [alb](references/alb.md), [clb](references/clb.md), [cloudcontrol](references/cloudcontrol.md) ([writes](references/cloudcontrol-write.md)), [cr](references/cr.md), [dns-edge](references/dns-edge.md), [ebs](references/ebs.md), [ecs](references/ecs.md), [iam](references/iam.md), [kms](references/kms.md), [mq](references/mq.md), [natgateway](references/natgateway.md), [observability](references/observability.md), [rds](references/rds.md), [redis](references/redis.md), [storage](references/storage.md), [vefaas](references/vefaas.md), [vke](references/vke.md), [vpc](references/vpc.md)

## Mandatory rules

1. **Version** — before any other `ve` command in a task, run `ve version` and require `ve >= 1.1.11`, also for product CLI delegation. Missing or older: [references/install.md](references/install.md).
2. **Read-only by default** — change resources only when the user explicitly asks.
3. **Leave the safety policy alone** — unless the user explicitly asks to change the policy itself, never run `ve configure safety-policy enable|disable|add|remove`, never read or edit `~/.volcengine/safety-policy.json`, never set `VOLCENGINE_SAFETY_POLICY_ENABLED`, `VOLCENGINE_SAFETY_POLICY_RULES` or `VOLCENGINE_SAFETY_SKIP_CONFIRM`.
4. **Confirmation mode** — before the first native call of a conversation (including `ve sts GetCallerIdentity`) run `ve configure safety-policy show`, then **read [references/safety.md](references/safety.md) before any write or destructive call**.
   - JSON with `"enabled": true` and non-empty `rules`: the CLI enforces. Run without `--yes`. `requires confirmation` → ask the user, end the turn, then re-run the identical command once with `--yes`. `blocked by safety policy` → stop; no other route.
   - Anything else: built-in rules. `Describe*/List*/Get*/Query*` run directly. `Create*/Run*/Allocate*/Attach*/Associate*/Authorize*` → show the full command and wait for confirmation. `Delete*/Terminate*/Release*/Revoke*/Modify*/Stop*/Detach*` → show command and impact; confirmation required. DryRun first when supported.
5. **Profile and region** — never choose or switch them yourself; pass `--profile` / `--region` only when the user explicitly selected one, then keep it.
6. **Login** — never call `ve login` directly and never ask the user to run it. Read [references/auth.md](references/auth.md) and use `scripts/ve_login_remote.sh`, also when a session expires mid-task.
7. **Errors** — when a command fails or returns `ResponseMetadata.Error`, read [references/common-errors.md](references/common-errors.md) completely before diagnosing. Permission errors: use `volcengine-troubleshooting`.

## Native OpenAPI execution flow

```text
1. Caller metadata on every command -> ve version -> ve configure safety-policy show (rule 4)
2. Run `ve sts GetCallerIdentity`. This IS the credential check: do not look at environment
   variables or config files. Report identity and region.
3. Is the user querying or changing something?
4. Locate the API: ve <service> | grep -> scripts/find_api.py -> --force if metadata lacks it
5. Parameters: --help; --help --detail for write/destructive actions
6. Dependent IDs: Describe*/List* with --query
7. Read -> execute and show results (--output table for lists)
   Write, built-in rules -> show command -> DryRun if supported -> user confirms -> execute
   Write, safety policy  -> execute -> if blocked or held, follow references/safety.md
8. Parse the response and report
```

Credential reminder: never run `env`, `printenv`, `set`, `export -p` or `echo $VOLCENGINE_*`, with or without a `sed`/`grep` filter, and never read `~/.volcengine/config.json`. `ve sts GetCallerIdentity` is the only credential check; if it fails, follow references/auth.md instead of inspecting the credentials.

© volcengine · MIT · volcengine/volcengine-agent-toolkit

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
volcengine-doubao-speech-tts calesthio Скилл volcengine-doubao-speech-tts для Claude Code настраивает синтез речи через Volcengine Doubao для потокового и длинного текста. CX Codex +1 134установок aws-vpc devops-skills Скилл aws-vpc разворачивает трёхуровневую сеть в AWS с публичными, приватными и изолированными подсетями. Пригодится при настройке сетевой инфраструктуры через CLI. CX Codex +1 366установок terraform-module-builder patricio0312rev Скилл terraform-module-builder помогает проектировать переиспользуемые модули Terraform с валидацией входных переменных, outputs и структурой каталогов. CX Codex +1 229установок aws-cloudformation-vpc Giuseppe Trisciuoglio Скилл aws-cloudformation-vpc для Claude Code содержит шаблоны CloudFormation для VPC и помогает создавать сетевую инфраструктуру AWS. CX Codex +1 ★ 372звёзд репо aws-drawio-architecture-diagrams Giuseppe Trisciuoglio Скилл aws-drawio-architecture-diagrams для Claude Code генерирует AWS-архитектуры в формате .drawio с официальными иконками aws4 по описанию инфраструктуры. CX Codex +1 ★ 372звёзд репо lifecycle-crud runpod Скилл lifecycle-crud для Claude Code управляет ресурсами Runpod: создаёт шаблоны, тома, креды реестра, секреты, SSH-ключи и Instant Clusters. Готовит инфраструктуру под GPU-вычисления и загрузку моделей на том. CX Codex +1 3 700установок

Из того же набора9

volcengine-find-skills Скилл volcengine-find-skills для Claude Code ищет навыки Volcengine в каталоге и устанавливает выбранные. Он подключается, когда нужно подобрать навык под задачу или закрыть пробел в текущей работе с Volcengine. CX Codex +1 292установок volcengine-feedback Скилл volcengine-feedback для Claude Code оформляет отзыв о работе с облачными сервисами Volcengine и после разрешения отправляет его в GitHub. Агент предлагает отзыв после ошибки CLI или незавершённой задачи, продолжая основную работу. CX Codex +1 216установок volcengine-api Скилл volcengine-api для Claude Code отвечает на вопросы о спецификациях API Volcengine. Он включается при поиске параметров, кодов ошибок, методов запросов и различий между API. CX Codex +1 154установок volcengine-deploy Скилл volcengine-deploy для Claude Code разворачивает локальный проект или Git-репозиторий в Volcengine как облачный сервис. Запускается по запросу опубликовать код, запустить приложение в облаке или развернуть его в ECS, VKE либо veFaaS. CX Codex +1 122установок volcengine-prepare Скилл volcengine-prepare для Claude Code разбирает репозиторий перед деплоем в Volcengine. Он определяет возможные варианты запуска на ECS, VKE и veFaaS и ранжирует их. CX Codex +1 119установок volcengine-tls Помогает агенту выполнять операции с Volcengine TLS через volclog. Он включается для поиска и анализа логов, а также работы с проектами и темами логов. CX Codex +1 118установок volcengine-sdk-generator Скилл volcengine-sdk-generator для Claude Code ищет API Volcengine и генерирует примеры вызовов SDK. Запускается на запросы о коде для Python, Go, Java, PHP, cURL и Node.js, а также о настройке SDK. CX Codex +1 112установок volcengine-iac Скилл volcengine-iac для Claude Code генерирует Terraform-конфигурацию для инфраструктуры Volcengine. Подключается, когда выбрана IaC или уже есть Terraform state. CX Codex +1 111установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой