不可变多架构镜像
基于 Ubuntu 24.04，支持 linux/amd64 与 linux/arm64。升级通过审阅后的镜像标签完成，而不是运行时自更新。
开源 · 自托管 · Docker 原生
AI 开发环境
你的 AI 开发环境，
随时随地。
在自托管、不可变的 Ubuntu 24.04 终端环境中运行 Claude Code、Codex CLI 与常用开发工具，支持 amd64 与 arm64。
/workspace
- src/
- docs/
- tests/
- docker-compose.yml
# 在 Docker 宿主机上
host$ docker compose up -d
host$ scripts/shell
# 容器内以 dev 用户
dev@ai-dev:/workspace$ tmux new -As dev
dev@ai-dev:/workspace$ claude
持久化卷 · docker sock · 多架构镜像
用 AI 构建，你需要的都在这里。
面向 AI 编程助手与日常开发的 Docker 原生终端环境。
AI 编程 CLI 就绪
预装 Claude Code、Codex CLI、Oh My ClaudeCode（OMC）、Oh My Codex（OMX）与 SaladDay cc-switch-cli。
持久化命名卷
项目、凭据、缓存、日志、模型与备份保存在六个命名卷中，容器重建后仍然保留。
容器内使用 Docker
Docker CLI / Compose / Buildx 通过宿主机 docker.sock 工作。能力很强——因此仅适合可信的单用户主机。
多语言工具链
镜像内含 Node.js、pnpm、Bun、Python/uv、Go、Rust、OpenJDK、GitHub CLI 以及常用开发工具。
终端 + tmux 工作流
通过 scripts/shell 或 scripts/tmux 进入。宿主机 SSH 断开后仍可保持会话；镜像不提供容器内 SSH 服务。
为持久的 AI 编程会话而设计。
终端优先——以下为示意，并非产品截图。
// 示意面板 1
$ docker compose up -d
$ scripts/shell
$ scripts/exec ai-dev doctor
足以支撑严肃开发
把工具链、AI CLI 与项目状态放在一起。重建容器时不必丢掉 /workspace 或 /config。
// 示意面板 2
$ docker compose up -d
$ scripts/shell
$ scripts/exec ai-dev doctor
不必每次重建环境再开始 AI 工作流
凭据与工具主目录通过配置代（generation）解析，Claude、Codex 与 gh 在重启后仍可继续使用。
// 示意面板 3
$ docker compose up -d
$ scripts/shell
$ scripts/exec ai-dev doctor
先到宿主机，再进容器 shell
没有容器内 SSH 服务。先到达 Docker 宿主机，再使用 scripts/shell 或 scripts/tmux 进入受支持的 dev 身份。
工作原理
从可信 Docker 主机到可用 AI 开发 shell，只需三步。
01
启动
在具备 Engine、Compose v2 与可用 docker.sock 的 Linux Docker 主机上：
bash
docker compose up -d02
进入
以 dev 用户打开受支持的 Zsh 会话（不是 Web 应用地址，也不是 SSH 进容器）：
bash
scripts/shell
# 或持久会话：
scripts/tmux03
开始构建
按需完成工具登录，然后在 /workspace 中与 AI 编程助手一起开发。
bash
scripts/exec claude auth login
scripts/exec codex login --device-auth带上你常用的 AI 编程助手。
面向镜像内预装的 AI 编程工具。它们是随镜像提供的 CLI，而不是额外的 SaaS 控制台。
Claude Code
预装的智能编程 CLI。使用 scripts/exec claude auth login 登录，状态保存在当前配置代中。
Codex CLI
预装的 OpenAI Codex CLI。无图形服务器上可用 scripts/exec codex login --device-auth 完成设备登录。
Oh My ClaudeCode（OMC）
镜像内含锁定版本的 OMC CLI。项目级插件配置是 /workspace 下按仓库进行的 Claude Code 工作流。
Oh My Codex（OMX）
新配置卷会离线完成用户级 OMX 初始化。项目级配置仍保留在 /workspace 仓库本地。
cc-switch-cli
SaladDay 无头 TUI/可脚本 CLI，用于 Claude 提供方切换——不是同名桌面 GUI。
几分钟即可开始。
前提：Linux Docker 主机、Docker Engine、Compose v2、可用 /var/run/docker.sock、amd64 或 arm64。默认镜像： docker.io/jerry0510/ai-dev:latest
1. 克隆
bash
git clone https://github.com/mufeng510/ai-dev-server.git
cd ai-dev-server2. 启动
bash
docker compose up -d
# optional:
# PUID="$(id -u)" PGID="$(id -g)" TZ=Asia/Shanghai docker compose up -d
# AI_DEV_IMAGE=docker.io/jerry0510/ai-dev:1.2.3 docker compose up -d3. 进入环境
bash
scripts/shell
# durable tmux session:
scripts/tmux没有发布 Web 应用端口，也没有容器内 SSH 服务。若在远程机器使用，先到达 Docker 宿主机，再执行上述脚本。
适用场景
部署在你已经掌控的主机上。
个人 AI 开发
在自己的机器或服务器上，用一个可信容器运行 Claude Code、Codex 与完整工具链。
远程开发
从其他设备连接到 Docker 宿主机，再用 scripts/shell 或 scripts/tmux 进入。容器本身不暴露 SSH 服务。
Homelab / NAS
若 NAS 或家庭实验室可运行 Linux Docker 并提供 docker.sock，可在相同安全假设下托管该环境。
可复现的开发环境
固定镜像标签，状态放入命名卷，重建容器时不必从零搭建个人工具链。
常见问题
什么是 AI Dev Server？
以多架构 Docker 镜像分发的不可变 Ubuntu 24.04 终端开发环境。预装 AI 编程 CLI、语言工具链与 Docker 客户端工具，状态保存在命名卷中。
为什么使用 Docker？
镜像保持不可变，项目与凭据放在卷中。你可以重建容器、固定版本，并获得一致工具链，而不污染宿主机用户环境。
支持哪些 AI 编程工具？
镜像预装 Claude Code、Codex CLI、Oh My ClaudeCode（OMC）、Oh My Codex（OMX）与 SaladDay cc-switch-cli。认证需手动完成，并持久化在当前 /config 配置代中。
可以在 NAS 上运行吗？
若 NAS 提供 Linux Docker Engine、Compose v2，以及 amd64/arm64 上可用的 docker.sock，可以——前提是遵循同一套可信单用户安全模型。
可以自定义开发环境吗？
可在 /workspace 中按项目安装依赖。镜像内容通过审阅后的重建/标签变更，而不是运行时自我更新。
源代码存在哪里？
项目位于挂载为 /workspace 的 workspace 卷。配置与凭据在 /config 配置代中。data、logs、models、backups 各有独立卷。
有没有基于浏览器的产品界面或本地 Web 端口？
没有。AI Dev Server 以终端为先，不提供浏览器产品界面。Compose 不发布应用 HTTP 端口。请使用 scripts/shell 或 scripts/tmux 进入。
容器是否提供自己的 SSH 服务？
不提供。镜像不运行 SSH 守护进程。请先连接到 Docker 宿主机，再使用 scripts/shell；可用 tmux 在断开后保持会话。
是开源的吗？
是的，项目采用 MIT 许可证。
如何贡献？
阅读 CONTRIBUTING.md，保持持久化与安全约定，为行为变更补充测试，并在 GitHub 提交拉取请求。