Русский
Начать

Agent Sandboxes Агенты для кода уже установлены

Агенты для кода в облаке: Claude Code, Codex и OpenCode

Запускайте Claude Code, Codex или OpenCode в облаке с полной автономией, каждый в ВМ, созданной под задачу: внутри агент может делать что угодно, и ни одного вашего ключа у него нет.

Три агента для кода, уже установлены

В нашем шаблоне base установлены Claude Code, Codex и OpenCode с их официальными SDK, а их CLI лежат в PATH: claude, codex, opencode. Каждый работает, не спрашивая разрешений: Claude Code в режиме bypassPermissions, Codex с полным доступом и без подтверждений, OpenCode со всеми разрешениями и выключенным инструментом вопросов, потому что отвечать на них некому. Граница — сама песочница: микроВМ Firecracker с собственным ядром, где у агента есть root и доступ туда, куда пускает ваш список разрешенных адресов.

Один вызов на промпт

prompt_agent дает агенту промпт в новом разговоре или в том, который вы назовете, с моделью и рабочей папкой, если они нужны, и ждет ход до 45 секунд. В разговоре идет один ход за раз: следующие промпты встают в очередь. Ход возвращает свое состояние (QUEUED, RUNNING, DONE, FAILED, STOPPED или LOST), последнее сообщение агента до 16 KiB и сколько токенов он прочел и написал. get_agent_turn дожидается более долгого хода, а stop_agent_turn его завершает.

watch_conversation потоком отдает все, что делает агент, в одном виде для всех трех агентов: каждый промпт, каждое сообщение, которое он пишет, каждый вызов инструмента с входными данными в JSON, каждый результат и конец каждого хода. Когда ход заканчивается, агент завершается вместе с ним, но то, что он запустил в фоне, продолжает работать: поднятый им dev-сервер по-прежнему открывается по превью-адресу.

import os
from pethost.sandboxes import EnvVar, Environment, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # читает PETHOST_TOKEN
key = os.environ["ANTHROPIC_API_KEY"]
sandboxes.set_secret("anthropic", value=key, hosts=["api.anthropic.com"])
env = Environment(variables=[EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")])
box = sandboxes.create_sandbox(settings=SandboxSettings(environment=env))

prompt = "Write fizzbuzz.py with a test and run it"
turn = sandboxes.prompt_agent(box.sandbox_id, prompt=prompt, wait_seconds=0)
conversation = turn.conversation_id
for event in sandboxes.watch_conversation(box.sandbox_id, conversation_id=conversation):
    if event.tool_call:
        print("›", event.tool_call.name, event.tool_call.input[:60])
    elif event.turn_end:
        print(event.turn_end.state.name, event.turn_end.reply)
        break
pethost sandbox secret set anthropic --host api.anthropic.com < key.txt
pethost sandbox new --name fizzbuzz --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox agent fizzbuzz "Write fizzbuzz.py with a test and run it"
pethost sandbox agent fizzbuzz --agent opencode "Explain fizzbuzz.py"

Вход без ключа внутри

Храните API-ключ как секрет рабочего пространства и привяжите его к ANTHROPIC_API_KEY или OPENAI_API_KEY. Переменная внутри песочницы хранит заглушку, а прокси исходящего трафика снаружи ВМ подставляет настоящий ключ в заголовки запроса — только по дороге к хостам, указанным в секрете, например api.anthropic.com. Программа, которая печатает свое окружение, видит заглушку. Как устроены секреты, которых нет в песочнице.

Или человек один раз входит в терминале песочницы, через claude auth login или codex login --device-auth. OpenCode входа вообще не требует: без ключа провайдера он работает на собственных бесплатных моделях OpenCode. Промпт агенту, который не может достучаться до своей модели, отклоняется с указанием переменной, которую нужно задать, и команды для входа, так что ваш код может сказать, чего не хватает.

Разговор остается в песочнице

История разговора лежит на диске песочницы. Пауза сохраняет ее вместе с файлами и процессами агента, и следующий промпт продолжает с того же места. Форк переносит ее: скопируйте песочницу между двумя ходами в десять копий и отправьте разговору в каждой следующий промпт в своем направлении. Шаблон разговоров не хранит: песочница, запущенная из него, начинает без них.

Чтобы смотреть, как работает агент, читайте поток его разговора или откройте страницу песочницы в панели: на вкладке «Агенты» видны ее разговоры.

Ограничения и цены

В разговоре один ход за раз. Агент работает на vCPU и памяти песочницы, которые оплачиваются посекундно по цене ее размера: 0,018 $ в час для SMALL (2 vCPU, 4 GiB) и 0,036 $ для DEFAULT (4 vCPU, 8 GiB). Пока идет ход, песочница не засыпает; между ходами, после 5 минут простоя, она встает на паузу за 30% от этой цены. Токены модели — это счет вашего провайдера, а не наш.

Сравнение с другими

На 21 ноября 2026 года прокси boat.dev, который не пускает ключи ИИ-сервисов в его песочницы, стоил 1 $ за каждый день, пока он включен, плюс 1 $ за 1 000 запросов. В Pethost подстановка ключа есть в каждой песочнице, для любого ключа и любого HTTPS-хоста, который вы назовете, и отдельной цены у нее нет.

Читать документацию

Вопросы

Нужен ли API-ключ, чтобы запустить Claude Code в песочнице?

Для Claude Code и Codex нужен либо ключ, привязанный как секрет, либо вход человека в терминале. Claude Code также входит через CLAUDE_CODE_OAUTH_TOKEN, Bedrock или Vertex. OpenCode работает без ключа, на собственных бесплатных моделях.

Попадает ли мой ключ в песочницу?

Нет, если он секрет: агент и все процессы видят заглушку, а ключ добавляется к запросам снаружи ВМ. Вход, выполненный в терминале, хранится внутри песочницы, как на вашем компьютере.

Можно ли разветвить разговор?

Да: сделайте форк песочницы. Каждая копия переносит разговор, и промпт с его id продолжает оттуда только в этой копии.

Можно ли смотреть, как работает агент?

Да: получайте поток его разговора через watch_conversation или откройте песочницу в панели. Ссылка на терминал, в котором запущен claude, дает вам собственную сессию рядом.

По теме

Дайте агенту компьютер за 0,15 с

Начать пробный период