aw – Workspace para Agentes de IA em Contêineres
konono/aw
Execute agentes Claude autonomamente em contêineres isolados, sem parar para confirmações
Ver no GitHubExecutor autônomo para agentes Claude Code em contêineres descartáveis, eliminando confirmações de permissão e permitindo operações sem supervisão. Suporta múltiplos agentes (Claude, Codex, OpenCode), git worktrees automáticos e ambientes isolados com Docker ou Podman.
Instalação
npx convez-ai konono/aw1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Executar agentes de IA enquanto você está ausente (reuniões, pausas)
- Experimentar com segurança sem poluir o sistema host
- Trabalhar em múltiplos branches em paralelo com worktrees automáticas
- Ambiente reprodutível entre desenvolvedores via .aw.yml
- Integração com mise/devbox para rastreamento de dependências
Veredito

Ferramenta bem pensada que resolve um problema real: agentes de IA presos esperando confirmações enquanto host está preso em contêiner. Implementação sólida em Go com suporte a múltiplos runtimes e agentes, mas requer familiaridade com containerização e CLI para aproveitar completamente.
README
A tradução para o português deste README ainda está na fila.
aw
AI コーディングエージェントを、使い捨てコンテナで自律的に動かすためのワークスペースランチャー。
なぜ aw を作ったか
Claude Code で作業中、fetch のたびに Yes/No を聞かれる。5回 Enter を押して、考え始めたのを見て子どもの寝かしつけに向かう。1時間後に戻ると「このURLをfetchしていいですか?」で止まっていて、タスクはほぼ進んでいない。
問題の本質は、ホストマシン上でエージェントを動かすと権限を与えるのが怖いこと。 だから毎回確認が入り、人間が離席すると止まる。
aw は どんなに汚れても壊れても困らない使い捨てコンテナ を立ち上げ、その中でエージェントを全権限で自律実行させます。ファイルを書き換えても、パッケージを入れても、ホストには影響しない。だから安心して --dangerously-skip-permissions で走らせられる。
go install github.com/konono/aw@latest
aw # 使い捨て Debian コンテナで Claude Code が自律起動。あとは放っておくだけ。
こういう場面で威力を発揮する
離席中にエージェントを走らせたい — 寝かしつけ、会議、昼休み。戻ったらタスクが終わっている。権限確認で止まることがない。
ホストを汚したくない — エージェントが npm install しようが pip install しようが、コンテナを捨てれば元通り。プロジェクトごとに隔離された環境で安全に実験できる。
メインブランチを汚さずに作業させたい — worktree: {} を設定しておくだけで、aw を実行するたびに自動で git worktree が切られ、独立したブランチで作業が始まる。エージェントがどんなにコードを壊しても、worktree を消せば元通り。気に入った結果だけ PR にすればいい。
複数タスクを並列で進めたい — ターミナルを複数開いてそれぞれ aw を実行すれば、タスクごとに独立した worktree + コンテナでエージェントが同時に走る。互いに干渉しない。zellij と組み合わせればマルチペインで一覧性も確保できる。
チームで環境を統一したい — .aw.yml をコミットすれば、全員が同じエージェント環境を再現できる。「自分の環境では動く」がなくなる。
特徴
- ゼロコンフィグで即起動 — インストール後すぐに
awでコンテナが立ち上がる - Claude / Codex / OpenCode 対応 — プロファイルを切り替えるだけ
- Docker / Podman 両対応 —
container_runtime: podmanで切り替え - mise / devbox 対応 — エージェントの試行錯誤を
mise.tomlやdevbox.jsonに落として再現可能に - git worktree 自動生成 — 実行するたびに独立ブランチで作業。壊しても消せば終わり
- プレビルドイメージ対応 —
image:で事前ビルド済みイメージを指定。エアギャップ環境に対応 - マルチ OS テンプレート — Debian 12 / UBI 9 / UBI 10 / Ubuntu 26.04
- カスタムコンテナユーザー —
container_user:でコンテナ内ユーザーを変更可能 - SSH Agent 転送 — 鍵ファイルをコンテナに入れずに Git 操作
- ホスト設定の自動同期 — Git / Claude 設定を引き継ぎ(GitHub CLI はオプトイン)
クイックスタート
go install github.com/konono/aw@latest
aw # デフォルトの claude プロファイルで Debian コンテナが起動
設定ファイルなしでそのまま使えます。カスタマイズしたくなったら:
aw init # ~/.config/aw/config.yml にスターター設定を書き出す
Linux での事前設定(Podman を使う場合)
Linux で Podman をルートレスモードで使う場合、事前に以下のコマンドを実行してください。これを行わないとコンテナのビルド時に Permission denied で失敗します。
sudo loginctl enable-linger $(whoami)
これは systemd のユーザーセッションを永続化する設定です。Podman のルートレスモードは cgroupv2 の管理に systemd ユーザーセッションを必要としますが、SSH ログインなど一部の環境ではセッションが自動的に作られないため、この設定が必要になります。詳しくは トラブルシューティング を参照してください。
組み込みプロファイル
| プロファイル | ツール | OS |
|---|---|---|
claude (デフォルト) | Claude Code | Debian 12 |
codex | Codex | Debian 12 |
opencode | OpenCode | Debian 12 |
shell | bash | Debian 12 |
ubi9-shell | bash | UBI 9 |
ubi10-shell | bash | UBI 10 |
ubuntu2604-shell | bash | Ubuntu 26.04 |
aw # claude(デフォルト)
aw codex # Codex で起動
aw shell # コンテナ内シェル
aw profiles # 一覧を表示
使い方
aw [profile-name] # プロファイルを実行
aw profiles # 利用可能なプロファイル一覧
aw auth login claude|codex|opencode # ツールの認証
aw auth status claude # 認証状態の確認
aw login claude # auth login の短縮形
aw init # スターター設定を書き出す
aw export <profile> [options] # イメージをビルドして tar 出力
aw default-dockerfile # デフォルト Dockerfile を出力
aw update # セルフアップデート
aw --version # バージョン表示
認証の詳細は docs/authentication.md を参照してください。
過去のディレクトリから起動する
--recent を使うと、過去に aw を起動したディレクトリ一覧から選んで、そのディレクトリでプロファイルを起動できます。
aw --recent # 履歴から選択して起動
aw codex --recent # 履歴から選択して codex で起動
aw claude --recent --query dotfiles # 初期クエリ付きで選択
-C / --cwd で特定のディレクトリを直接指定することもできます。
aw -C ~/src/my-project # 指定ディレクトリで起動
aw codex --cwd ~/src/my-project # 指定ディレクトリで codex を起動
選択 UI は aw に内蔵されているため、fzf を別途インストールする必要はありません。
履歴は ${XDG_STATE_HOME:-$HOME/.local/state}/aw/dirs.json に保存されます。
設定
設定は以下の順序でマージされます:
ビルトインデフォルト → ~/.config/aw/config.yml → .aw.yml
default: claude
container_runtime: podman
environment: container
ssh_agent_forwarding: true
profiles:
claude:
launch: claude
codex:
launch: codex
auth:
on_launch:
check: warn
worktree-zellij:
worktree: {}
launch: zellij
zellij:
tool: claude
全オプションの詳細は docs/configuration.md を参照してください。
使用例
Worktree で使い捨てブランチ作業
worktree: {} を付けるだけで、aw を実行するたびに自動で worktree が作られる。エージェントの作業はメインブランチから完全に隔離され、結果が気に入らなければ worktree ごと捨てればいい:
profiles:
worktree-claude:
worktree: {} # 実行ごとに自動で worktree を作成
environment: container
launch: claude
ターミナルを複数開いて aw worktree-claude を実行すれば、それぞれ独立した worktree + コンテナで並列作業もできる。zellij と組み合わせてマルチペインにすることも可能:
profiles:
worktree-zellij:
worktree:
base: origin/main
on-create: "./scripts/setup.sh"
environment: container
launch: zellij
zellij:
tool: claude
Vertex AI で Claude を使う
profiles:
claude-vertex:
environment: container
launch: claude
env:
CLAUDE_CODE_USE_VERTEX: "1"
CLOUD_ML_REGION: "us-east5"
ANTHROPIC_VERTEX_PROJECT_ID: "my-gcp-project"
mounts:
- source: "~/.config/gcloud"
target: "/home/agent/.config/gcloud"
readonly: true
プレビルドイメージ(エアギャップ環境)
ネットワークのある環境でイメージを書き出し、オフライン環境に持ち込む:
# 基本的なエクスポート
aw export claude -o my-image.tar
# --snapshot: ワークスペースのパッケージもイメージに焼き込み
aw export claude --snapshot -o my-image.tar
# --include: ホストのディレクトリをイメージにコピー(--snapshot を暗黙有効化)
aw export claude --include ./certs:/usr/local/share/ca-certificates
# --env: 環境変数をイメージに焼き込み(--snapshot を暗黙有効化)
aw export claude --env HTTP_PROXY=http://proxy.corp:8080
# USB 等で転送
docker load -i my-image.tar # オフライン環境でロード
export オプションはプロファイルの export: セクションでも指定できる:
profiles:
airgap:
environment: container
launch: claude
image: 'aw-container:a1b2c3d4e5f6'
skip_devbox_install: true # プロジェクトの devbox install をスキップ
skip_mise_install: true # プロジェクトの mise install をスキップ
export:
snapshot: true
include:
- src: ./certs
dst: /usr/local/share/ca-certificates
env:
HTTP_PROXY: http://proxy.corp:8080
カスタム Dockerfile(Playwright)
profiles:
playwright:
environment: container
launch: claude
dockerfile: playwright-docker/Dockerfile
詳細は docs/custom-dockerfile.md を参照してください。
必要なツール
| ツール | 必要な場面 |
|---|---|
docker または podman | environment: container |
git | worktree を使用する場合 |
zellij | launch: zellij |
アンインストール
rm ~/go/bin/aw # バイナリ
rm -rf ~/.agent-workspace # データ
docker volume rm claude-code-local # キャッシュ(Podman の場合は podman)
docker rmi claude-code-docker # イメージ
ドキュメント
| ガイド | 内容 |
|---|---|
| 設定リファレンス | 全オプション、バリデーションルール、マージモデル |
| 認証ガイド | ツール別の認証設定 |
| コンテナ同期 | ホスト設定の同期、SSH、データ保存先 |
| カスタム Dockerfile | 独自イメージの作成方法 |
| パッケージ管理 | mise / devbox によるコンテナ内ツール管理 |
トラブルシューティング
Podman でイメージビルド時に Permission denied になる
error running container: from /usr/bin/crun creating container for [...]:
sd-bus call: Interactive authentication required.: Permission denied
原因: Podman のルートレスモードは、コンテナの cgroup を管理するために systemd のユーザーセッション(systemd --user)を使います。しかし SSH 経由のログインや、GUI を使わないサーバー環境では、systemd ユーザーセッションが自動的に開始されないことがあります。セッションが存在しない状態でコンテナを作成しようとすると、crun が systemd の D-Bus API を呼び出した際に認証エラーとなります。
解決方法:
sudo loginctl enable-linger $(whoami)
loginctl enable-linger は、対象ユーザーの systemd ユーザーセッションをログイン状態に関係なく永続化します。これにより、SSH セッションやサーバー環境でも Podman がルートレスで正常に動作するようになります。
この設定は一度実行すれば永続的に有効です。再起動後も維持されます。
Acknowledgments
Originally forked from hiragram/agent-workspace.