다양한 안전 모드, 샌드박스 격리, git worktree 및 명령 별칭을 사용하여 Docker Agent를 실행하고 관리합니다.
- GitHub 스타
- 626
- 파일
- 6
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- Apache-2.0
- 허용된 도구
- —
docker-agent-run skill은 무엇을 하나요?
다양한 안전 모드, 샌드박스 격리, git worktree 및 명령 별칭을 사용하여 Docker Agent를 실행하고 관리합니다.
skill의 SKILL.md에서 생성된 요약입니다.
docker-agent-run skill 정보
이 SKILL은 개발자가 Docker Agent의 실행 및 운영 라이프사이클을 관리할 수 있도록 지원합니다. 로컬 설정, 레지스트리 참조 또는 사전 정의된 별칭을 사용하여 docker agent run 명령으로 에이전트를 호출할 수 있는 도구를 제공합니다. 사용자는 엄격한 승인 요구 사항부터 완전 자율 실행에 이르기까지 다양한 안전 모드를 선택하여 도구 호출 시 에이전트의 자율성을 제어할 수 있습니다.
보안이 중요한 경우, sandbox flag를 사용하여 격리된 microVM 내에서 에이전트를 실행할 수 있습니다. 이 격리 기능을 사용하려면 sbx CLI가 필요하며, 허용 목록을 통해 세밀한 네트워크 제어가 가능합니다. 또한 개발자는 git worktree를 사용하여 에이전트의 파일 수정 사항을 메인 워크스페이스와 분리하거나, doctor 명령을 사용하여 모델 가용성 및 인증 관련 문제를 진단할 수 있습니다. 이 SKILL은 에이전트 설정을 작성하기보다는 기존 에이전트를 실행하고 문제를 해결하는 데 특화되어 있습니다.
agent가 수행할 수 있는 작업
- 1에이전트 자율성 수준 구성비대면 작업 시 안전하다고 명시되지 않은 모든 도구 호출을 자동으로 거부하도록 에이전트를 설정합니다.
- 2샌드박스 내 에이전트 활동 격리에이전트의 파일 시스템 및 프로세스 활동이 격리되도록 microVM 내부에서 에이전트를 실행합니다.
- 3에이전트 실행 실패 진단에이전트 실행 실패의 원인이 모델 인증 정보 또는 프로바이더 가용성 문제인지 확인합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
docker-agent-run skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.플러그인에 docker-agent-run skill 설치
/plugin marketplace add docker/skills /plugin install docker-skills@docker
Claude Code에 docker-agent-run skill 설치
~/.claude/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.claude/skills/docker-agent-runClaude Code (project)에 docker-agent-run skill 설치
.claude/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run .claude/skills/docker-agent-runCodex에 docker-agent-run skill 설치
~/.agents/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.agents/skills/docker-agent-runGemini CLI에 docker-agent-run skill 설치
~/.gemini/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.gemini/skills/docker-agent-runClaude.ai에 docker-agent-run skill 설치
npx degit docker/skills/skills/docker-agent-run docker-agent-run && zip -r docker-agent-run.zip docker-agent-run # claude.ai → Customize → Skills → + → Create skill → Upload a skill → docker-agent-run.zip
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능docker/skills/skills/docker-agent-run is public and reachablegithub.com/docker/skills/tree/HEAD/skills/docker-agent-run ↗통과
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-10github.com/docker/skills/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 155 linesgithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗통과
SKILL.md
GitHub에서 보기Docker Agent: Running and Operating Agents
Overview
This skill owns the operational side of Docker Agent: invoking docker agent run against a local config, an alias, or a registry reference; choosing how
much autonomy the agent gets over tool calls; isolating it in a sandbox VM;
and diagnosing why a run fails. It assumes the agent.yaml already exists —
see Related skills for authoring it.
When to use this skill
Activate this skill when:
- The user wants to run an agent interactively or headlessly (
--exec). - The user is choosing or debugging
--safety,--yolo, or approval behavior for tool calls. - The user wants to isolate an agent's shell/filesystem access with
--sandbox, or hit a sandbox network-policy error. - The user wants a reusable shortcut (
docker agent alias), a scoped git worktree (--worktree), or is debugging credentials/model availability (docker agent doctor).
Do not use this skill when
Do not use this skill when:
- The task uses standalone
sbx run/create/stop/rmrather thandocker agent run --sandbox— usedocker-sandboxes-lifecycle. - The task is standalone
sbx policyorsbx secretconfiguration — usedocker-sandboxes-network-credentials. Establish which CLI is in use before recommending commands when the request only says "my sandbox". - The task is writing or editing the
agent.yamlitself (models, toolsets, sub_agents) — usedocker-agent-config. - The task is exposing an agent as a server (
serve), sharing it via a registry (share), or evaluating it (evaluation sessions,--baselineregression gates) — usedocker-agent-deploy.
Core guidance
Safety modes
docker agent runsupports four--safetymodes; choose the least permissive one that still lets the task finish:strict— ask for approval before every tool call.balanced— auto-approve calls classified as safe, ask for the rest.restricted— auto-approve safe calls, deny the rest outright. Use for unattended/CI runs where no human can answer a prompt.autonomous— approve everything automatically. Equivalent to--yolo.
- Never default an unattended run (cron, CI, a server endpoint) to
autonomous/--yolo. Userestrictedfor unattended runs so an unexpected tool call fails closed instead of running unreviewed; reserveautonomous/--yolofor a sandboxed or fully trusted interactive session.# CI-safe: unreviewed tool calls are denied, not silently approved. docker agent run --exec --safety restricted ./agent.yaml "Triage the failing test" - Bake a safety default into an alias so callers don't have to remember it,
and note that an explicit CLI
--safety/--yoloondocker agent runstill overrides the alias:docker agent alias add safe-coder myorg/coder --safety balanced
Sandbox isolation
--sandboxruns the agent inside an isolated microVM managed by thesbxCLI (a separate prerequisite — install and configure it first). All shell, filesystem, and process activity started by built-in toolsets happens inside the VM; only the working directory (and, unless--no-kit, a staged "kit" of skills/prompt files) is mounted in. Exception: a local stdio MCP server declared on the agent runs as a host process outside the sandbox VM — treat any such MCP server as a trusted host integration, not a sandboxed one.docker agent run --sandbox ./agent.yaml- The sandbox network proxy is default-deny: only the model provider,
models.dev, and hosts the toolset resolver can infer are open. A custom MCP server or third-party API often needs an explicit allowlist entry — add it permanently rather than re-discovering it every run:docker agent sandbox allow api.example.com docker agent sandbox list docker agent sandbox deny api.example.com - Prefer baking
runtime: {sandbox: true}into the agent's ownagent.yamlover remembering--sandboxon every invocation of that agent; an explicit--sandbox=falseon the CLI still overrides the config default for a single debug run. - Sandboxes persist and are reused across runs from the same workspace — they are not torn down when the session ends. Don't expect a clean VM on every run; if you need one, change the mount set (e.g. a new kit) to force recreation.
Aliases and default agent
- Register a shortcut once, then run it by name instead of a path:
docker agent alias add code myorg/notion-expert docker agent run code - For a local run with no agent argument,
docker agent rundiscoversdocker-agent.yaml, thendocker-agent.yml, thendocker-agent.hclin the current directory (first match wins). Only if none exists does it resolve thedefaultalias, falling back to the built-in default agent. Theagent.yamlexamples in these skills pass a filename explicitly;agent.yamlis not an auto-discovery name. - Set the fallback for directories without a project config with a
defaultalias. To select it even when a project config exists, passdefaultexplicitly:docker agent alias add default ./my-agent.yaml docker agent run default - CLI flags on
docker agent run <alias>always override the alias's own stored options (e.g.docker agent run yolo-coder --yolo=false).
Worktrees
- Use
--worktree(-w) to isolate an agent's file edits from your current checkout — it runs the agent inside a fresh git worktree. For an interactive session, a clean worktree (no uncommitted changes, untracked files, or new commits) is removed automatically when the session ends; one with work prompts you to keep or remove. A headless run (--exec) never auto-cleans its worktree, regardless of state — it is left in place for inspection:docker agent run ./agent.yaml --worktree=auth-refactor --worktree-base origin/main --worktreecannot be combined with--remoteor--sandbox. To resume a worktree run, pass--session -1(or the session id) — do not re-pass--worktree, which fails because the worktree already exists.
Troubleshooting
- "No model is currently available" or "model ... is not pulled" means the
agent's provider has no usable credential, or (for
dmr/) the model hasn't been pulled. Rundocker agent doctor ./agent.yamlfirst — it reports the resolved model/provider and whether credentials were found — before touching the YAML. If credentials are missing, export the provider's API key; if a DMR model is missing, rundocker model pull <model>. Rerundoctorbefore retrying the task. - An agent that only describes a plan instead of executing it is usually
missing the tool it needs (add
type: shellortype: todoinagent.yaml), not a model failure — hand this back todocker-agent-config. - A
403 Blocked by network policyerror inside a sandbox run means the destination isn't allowlisted; usedocker agent sandbox allow <host>.
Related skills
- For standalone
sbxlifecycle commands, usedocker-sandboxes-lifecycle. - For standalone
sbx policyandsbx secret, usedocker-sandboxes-network-credentials. - For writing or changing the underlying
agent.yaml(models, toolsets, sub_agents), usedocker-agent-config. - For serving, sharing, or evaluating the agent, use
docker-agent-deploy.
References
references/safety-and-sandbox.md— full safety-mode/flag interaction table and sandbox trust-boundary details.references/sources.md— provenance of every rule in this skill.
Assets
- None.
Checks
checks/verification.md— Verification runbook for adocker agent runinvocation.
이 스킬의 파일
6docker-agent-run skill 질문
Claude Code에 docker-agent-run skill을 어떻게 설치하나요?
npx degit docker/skills/skills/docker-agent-run ~/.claude/skills/docker-agent-run를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
docker-agent-run skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
Docker Agent 실행 시 사용할 수 있는 안전 모드는 무엇인가요?
strict(모든 도구 호출 승인), balanced(안전한 호출 승인), restricted(미분류 호출 거부), autonomous(모든 작업 승인)의 네 가지 모드가 있습니다.
'No model is currently available' 오류가 발생하면 어떻게 해야 하나요?
'docker agent doctor'를 실행하여 프로바이더의 인증 정보가 유효한지 또는 모델을 pull해야 하는지 진단하십시오.
샌드박스 모드의 에이전트가 특정 API에 접근할 수 있도록 허용하려면 어떻게 하나요?
'docker agent sandbox allow' 명령을 사용하여 호스트를 네트워크 허용 목록에 추가하십시오.