mirror of
https://github.com/trailofbits/claude-code-devcontainer
synced 2026-06-21 14:11:48 +00:00
Add Colima optimization guide for Apple Silicon
Adds a collapsible section after Prerequisites with optimized Colima settings (vz + virtiofs) that provide 5-10x faster file I/O compared to defaults (QEMU + sshfs). Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -17,6 +17,37 @@ A pre-configured sandboxed development environment for Claude Code with `--dange
|
||||
- [Docker Desktop](https://docker.com/products/docker-desktop) - ensure it's running
|
||||
- [Colima](https://github.com/abiosoft/colima): `brew install colima docker && colima start`
|
||||
|
||||
<details>
|
||||
<summary><strong>Optimizing Colima for Apple Silicon</strong></summary>
|
||||
|
||||
Colima's defaults (QEMU + sshfs) are conservative. For better performance:
|
||||
|
||||
```bash
|
||||
# Stop and delete current VM (removes containers/images)
|
||||
colima stop && colima delete
|
||||
|
||||
# Start with optimized settings
|
||||
colima start \
|
||||
--cpu 4 \
|
||||
--memory 8 \
|
||||
--disk 100 \
|
||||
--vm-type vz \
|
||||
--vz-rosetta \
|
||||
--mount-type virtiofs
|
||||
```
|
||||
|
||||
Adjust `--cpu` and `--memory` based on your Mac (e.g., 6/16 for Pro, 8/32 for Max).
|
||||
|
||||
| Option | Benefit |
|
||||
|--------|---------|
|
||||
| `--vm-type vz` | Apple Virtualization.framework (faster than QEMU) |
|
||||
| `--mount-type virtiofs` | 5-10x faster file I/O than sshfs |
|
||||
| `--vz-rosetta` | Run x86 containers via Rosetta |
|
||||
|
||||
Verify with `colima status` - should show "macOS Virtualization.Framework" and "virtiofs".
|
||||
|
||||
</details>
|
||||
|
||||
## Quick Start
|
||||
|
||||
### Option 1: VS Code / Cursor
|
||||
|
||||
Reference in New Issue
Block a user