---
title: "Установка Timeweb Cloud CLI и начало работы"
description: "Установка Timeweb Cloud CLI и начало работы. Документация и инструкции по работе с IT-инфраструктурой Timeweb Cloud."
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

`twc` — утилита командной строки для управления сервисами Timeweb Cloud. Ниже рассмотрим, как установить `twc` и приступить к работе.

> [!NOTE]
> Актуальная документация по работе с twc, сценарии использования утилиты, способы конфигурации и некоторые полезные приемы [доступны на GitHub](https://github.com/timeweb-cloud/twc/tree/master/docs/ru).

## Установка

Установить `twc` можно следующими способами.

### Установка с помощью pipx (рекомендованный способ)

1.  Убедитесь, что на компьютер установлены Python не ниже версии 3.8 и пакетный менеджер `pipx` (см. [инструкцию](https://pipx.pypa.io/stable/how-to/install-pipx/)).
2.  Установите пакет `twc-cli` с помощью `pip` командой:

```shell
pipx install twc-cli
```

### Установка из файла .tar.gz

1.  Убедитесь, что на компьютер установлены Python не ниже версии 3.8 и пакетный менеджер `pipx` (см. [инструкцию](https://pipx.pypa.io/stable/how-to/install-pipx/)).
2.  Скачайте пакет `twc-cli` в формате .`tar.gz` со [страницы загрузок](https://github.com/timeweb-cloud/twc/releases).
3.  Перейдите в терминале в директорию, где расположен файл .`tar.gz`, и установите его с помощью `pip`:

```shell
pipx install ./twc_cli-2.15.2.tar.gz
```

## Обновление

Рекомендуем регулярно обновлять `twc`. Команда для обновления:

```
pipx upgrade twc-cli
```

## Начало работы

1.  Прежде всего нужно получить токен доступа в панели управления Timeweb Cloud. Перейдите в раздел «[Токены API](https://timeweb.cloud/my/api-keys)» и выпустите новый токен с любым сроком действия.
2.  Откройте терминал и запустите команду:

```shell
twc config
```

3.  Введите токен и нажмите Enter. `twc` сохранит на вашем компьютере конфигурационный файл с токеном.

На этом настройка утилиты завершена, вы можете начать управлять сервисами.

`twc` содержит встроенную справку на английском языке. С ее помощью можно получить информацию обо всех доступных командах и опциях. Для вызова справки используйте:

```shell
twc --help
```

`twc` имеет множество субкоманд с различной степенью вложенности. Опция `--help` доступна на каждом уровне вложенности для всех субкоманд. Например, так можно последовательно прочитать справку по командам для управления облачными серверами:

```shell
twc server --help
```

```shell
twc server create --help
```

Для получения информации о доступных командах, субкомандах и опциях рекомендуем обращаться к справке.