# Claude Code Dev Container

> Claude Code running inside a dev container. Its commands stay in the box.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Claude Code devcontainer, Claude Code Dev Container Feature

## Think of it like

It is like a sandbox at the park. Whatever happens in the sand stays in the sand.

## Definition

A Claude Code dev container runs Claude Code inside a dev container. A dev container is a ready-made box that every person on a team runs the same way. The commands Claude runs then happen in the box, not on your computer. You add Claude Code with one line in the box's config file. Editors such as VS Code and JetBrains IDEs open the project inside it. It can also limit which websites the box may reach.

## Example

Emma's team adds one line to the config file. Now they all get the same tools, and Claude's commands stay off their laptops.

## Example code

```json
"features": {
  "ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {}
}
```

One line in the config file adds Claude Code to the box.

## Why it matters

The whole team gets one known setup. The agent's commands stay away from your own machine.

## Common mistake

Mounting your own SSH keys or cloud keys into the box. Anything inside it can be read by what runs there.

## Three principles

- **Same box for all.** One setup the whole team shares.
- **Commands stay inside.** Your laptop is not touched.
- **Not a full guard.** Only use trusted code inside.

## Related terms

- [Dev Container](https://learn.benibix.com/term/infrastructure/dev-container)
- [Claude Code Sandbox](https://learn.benibix.com/term/ai/claude-code-sandbox)
- [Agent Sandbox](https://learn.benibix.com/term/ai/agent-sandbox)
- [Container](https://learn.benibix.com/term/infrastructure/container)
- [Claude Code VS Code Extension](https://learn.benibix.com/term/ai/claude-code-vs-code-extension)

## Told apart from

- [Claude Code Dev Container vs Sandbox](https://learn.benibix.com/compare/claude-code-dev-container-vs-claude-code-sandbox): People think the sandbox and a dev container are the same wall. They are not. The sandbox wraps only the shell commands Claude starts, on your own computer. A dev container is a whole separate box, with its own tools and files, and Claude Code itself runs inside it. Use the sandbox for safe commands on your machine. Use a dev container to give a team one shared, walled-off setup.

![Three panels. The VS Code extension holds its own copy of Claude Code in a side panel. The JetBrains plugin runs the claude command in the IDE's terminal and links to it. A dev container box holds Claude Code, the terminal and the build tools, with the project folder mounted inside.](https://learn.benibix.com/diagrams/ai8-cc-editors.svg)

---

Source: https://learn.benibix.com/term/ai/claude-code-dev-container
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
