Безопасный режим?

dontAsk только чтение.

Руководство

Официальный Claude Agent SDK: честный аудируемый личный ассистент (2026)

Команда MacLogin по автоматизации ИИ 1 июня 2026 ~12 мин

Claude Agent SDK от Anthropic позволяет встроить в своё Python- или TypeScript-приложение тот же цикл инструментов, что и в Claude Code. Правило для новичков: начните с режима только чтения, добавьте честный system_prompt, затем расширяйте allowed_tools только после проверки журналов аудита.

См. также: Claude Code по SSH, Cursor Rules vs Skills, бенчмарки агента Opus 4.8.

Раскрытие: MacLogin публикует это руководство. Следуйте официальной документации Agent SDK и используйте API-ключ из Claude Console — не перепродавайте вход claude.ai в сторонних приложениях.

Зачем начинать с официального SDK

Обёртки часто скрывают, какие инструменты запускаются и что уходит с вашей машины. SDK документирует Read, Edit, Bash, permissions, hooks и sessions на code.claude.com.

Облачный Mac для расписания 24/7 необязателен; для первого защищённого помощника достаточно ноутбука.

Структура SDK

Слой	Роль	Вы настраиваете
`query()`	Цикл агента (план → инструмент → наблюдение)	`agent.py`
Tools	Файлы, shell, поиск, веб	`allowed_tools`
Permissions	Разрешить / отклонить / спросить	`permission_mode`
Policy	Честность, область	`system_prompt`, `CLAUDE.md`
Audit	Логирование использования инструментов	`hooks`

С 15 июня 2026 подписки учитывают Agent SDK через отдельный пул кредитов — закладывайте бюджет на бесконтрольные циклы.

Восьмишаговый защищённый runbook

Шаг 1 — Предварительные требования

python3 --version   # 3.10+
pip install claude-agent-sdk

Шаги 2–3 — Проект и установка

mkdir my-guarded-agent && cd my-guarded-agent
python3 -m venv .venv && source .venv/bin/activate
pip install claude-agent-sdk

Шаг 4 — API-ключ

# .env (gitignore this file)
ANTHROPIC_API_KEY=sk-ant-...

Шаги 5–6 — Честный промпт + запуск только для чтения

from claude_agent_sdk import query, ClaudeAgentOptions

HONEST = """Say "I don't know" when data is missing.
Never invent paths or command output."""

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Glob", "Grep"],
    permission_mode="dontAsk",
    system_prompt=HONEST,
)

Запуск: python3 agent.py — см. quickstart.

Шаги 7–8 — Hook аудита, затем правки

Добавьте hooks PostToolUse в audit.log перед включением Edit с permission_mode="acceptEdits". По желанию: AskUserQuestion для уточнений.

Устранение неполадок

API-ключ не найден

Исправление: Экспортируйте ANTHROPIC_API_KEY в той же оболочке; никогда не коммитьте .env.

pip: No matching distribution

Исправление: Используйте Python 3.10+; пересоздайте .venv.

thinking.type.enabled not supported

Исправление: Обновите Agent SDK до v0.2.111+ для Opus 4.7+ ([quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart)).

Неожиданные правки файлов

Исправление: Откатите через git; вернитесь к dontAsk и инструментам только для чтения, пока hooks не докажут безопасность.

FAQ

Agent SDK vs Claude Code?

Claude Code — интерактивное приложение; SDK — библиотека с query() и ClaudeAgentOptions.

Самый безопасный permission_mode?

dontAsk только с Read, Glob, Grep.

Использовать Opus 4.8?

Да — укажите модель в options. По-прежнему применяйте локальные списки разрешённых инструментов; см. руководство по бенчмаркам.

Нужен ли MacLogin?

Нет — достаточно API-ключа. Удалённый Mac для постоянно работающих агентов необязателен.

vs Messages API?

Messages API: цикл инструментов реализуете вы. Agent SDK: цикл Anthropic + встроенные инструменты — быстрее к защищённому v1.

Команда MacLogin по автоматизации ИИ

Гайды по Agent SDK, permissions и честным ассистентам.

Опционально: облачный Mac 24/7

Quickstart на ноутбуке—аренда Mac только для круглосуточных агентов.

Цены Справка