快速开始

准备

• Docker（macOS / Windows 上用 Docker Desktop，Linux 上用 Docker Engine）
• 一个终端。想从 tmux 里复制文字，见 tmux 里的终端设置。

镜像支持 linux/amd64 和 linux/arm64，在 Intel / AMD 电脑和 Apple 芯片上都是原生运行。

1. 拉取镜像

docker pull yeciorg/yeci

同一个镜像还有两个备用地址，Docker Hub 上的 yeciorg/yeci 拉取慢或拉不到时可以用：

docker pull ghcr.io/yeciorg/yeci    # GitHub Container Registry
docker pull tourcoder/yeci          # Docker Hub 原来的仓库

如果用了备用地址，下面 docker run 命令里的镜像名也要换成同一个。

2. 为项目启动一个容器

在项目目录下运行：

PROJECT_NAME=$(basename "$PWD")

docker run -d \
--rm \
--name "yeci-$PROJECT_NAME" \
--network host \
-v "$PWD":/workspace \
docker.io/yeciorg/yeci > /dev/null

各个参数的作用：

参数	作用
-d	在后台运行，容器会一直运行，直到你停止它。
--rm	容器停止时自动删除。项目文件不受影响（见下文）。
--name "yeci-$PROJECT_NAME"	每个项目一个容器，用项目目录名命名。
--network host	和宿主机共用网络，容器里启动的开发服务器可以直接用 localhost 访问。在 Docker Desktop（macOS / Windows）上，需要先在 Docker Desktop 的设置里开启 host 网络。
-v "$PWD":/workspace	把当前目录挂载到 /workspace，也就是容器的工作目录。

3. 打开 shell

docker exec -it "yeci-$PROJECT_NAME" /bin/bash

进入后就在 /workspace，也就是你的项目目录。在这里做的任何修改，都直接改在你的电脑上。

想分出多个窗格（比如一边跑 AI 助手、一边开 shell），就启动 tmux：

tmux

快捷键见 tmux。

4. 启动 AI 助手

claude    # 或者：codex、gemini、grok

第一次运行时会要求登录，见 AI 编程助手。

5. 停止容器

docker stop "yeci-$PROJECT_NAME"

因为加了 --rm，容器停止时会被删除。/workspace 里的文件在你的电脑上，不受影响；容器里的其他东西都会消失，包括 AI 助手的登录状态。想在重启后保留登录，见数据与持久化。