远程 Dev Container + 可断连的编码 Agent

§0你的四项决定 → 架构后果

§1基石：三层持久化

Claude Code 只是个普通前台进程。关机杀死它的是 SIGHUP，不是什么状态问题。

§2架构

Windows 笔记本
  │
  │  ssh myserver              (22，密钥，root)
  │  ssh -L 5173:localhost:5173 myserver     ← dev server 走隧道，不开安全组
  ▼
8.222.155.72   Alibaba Cloud Linux 4 · 新加坡
  │
  ├─ nginx  :80 :443  ────► jinghao.site  【生产站点，不许碰】
  │     └─ acme.sh cron，靠 :80 的 /.well-known/ 续期
  │
  ├─ dockerd            (unix socket only；容器一律不 publish 到 0.0.0.0)
  │
  ├─ /etc/devbox/minimax.env      chmod 600, root:root   ← MiniMax key + BASE_URL
  │                                                        (无任何 Anthropic 凭证)
  │  出网 → api.minimaxi.com  【新加坡→国内站，待实测，见 §5 坑一】
  │
  └─ 容器 devbox-<project>
       │  PID1 = sleep loop           ← L2（devcontainer 默认给的）
       │  以非 root 用户 dev 运行，uid 对齐宿主
       │
       ├─ tmux server                 ← L1
       │    └─ session "main"
       │         └─ claude ..........  ← agent 在这里跑
       │
       ├─ /workspaces/<proj>          ← bind mount ← /srv/dev/<proj>  (git clone 在这)
       │
       └─ /home/dev/.claude           ← named volume  (L3)
            └─ projects/<cwd>/*.jsonl   会话历史

重连：

ssh -t myserver docker exec -it -u dev devbox-myproj tmux attach -t main

§3与生产站点共存 硬约束

这台机器上跑着一个活的、有 TLS 证书自动续期的站点。以下每条都不是建议，是约束。

• 容器绝不 publish 端口到 0.0.0.0。 一律不带 -p，或只 -p 127.0.0.1:5173:5173。dev server 通过 SSH 本地端口转发访问 —— 既不碰 80/443，也不用改安全组。
• 装 Docker 前后各跑一次回归。 你 DEPLOYMENT.md §7 里有现成的假 token 脚本，专门验 /.well-known/acme-challenge/ 仍走明文 HTTP。那条路径被吃掉 = 证书两个月后静默过期 = 站点挂了你才知道。
• Docker 会往 iptables 插 DOCKER 链。 你 firewalld inactive、INPUT 策略 ACCEPT，唯一网络关卡是安全组。这意味着即使容器误 publish 了端口，外网也进不来。这是好事，但不要把它当唯一防线——安全组是你手动维护的，哪天放行了别的端口就漏了。
• 磁盘：40G 已用 22%。镜像 + Features 会吃掉不少。每个语言 Feature 层几百 MB 起。留意 docker system df。

§4多语言：让 devcontainer.json 当唯一事实源

你要"不同容器不同语言"，又要"CLI 和 VS Code 两种入口"。如果分别配，必然漂移成两套系统。

解法是把语言声明推进每个项目的 .devcontainer/devcontainer.json，用官方 Features 声明式装工具链：

// /srv/dev/myproj/.devcontainer/devcontainer.json
{
  "name": "myproj",
  "image": "devbox-base:latest",          // 瘦 base：claude-code + tmux + git + rg/fd/jq
  "features": {
    "ghcr.io/devcontainers/features/go:1":     { "version": "1.23" },
    "ghcr.io/devcontainers/features/python:1": { "version": "3.12" }
  },
  "remoteUser": "dev",
  "runArgs": ["--env-file", "/etc/devbox/anthropic.env"],
  "mounts": [
    "source=devbox-claude-myproj,target=/home/dev/.claude,type=volume"   // L3
  ]
}

然后两个入口读同一份配置：

Features 从 ghcr.io 拉取，需要出网。新加坡节点应该没问题，但 Phase 0 要测。

§5MiniMax 接入

Claude Code 可以指向任何 Anthropic 协议兼容的网关。MiniMax 提供了一个。配置不难，难的是它带来的四件事。

按官方文档（platform.minimaxi.com/docs/token-plan/claude-code）：

# /etc/devbox/minimax.env      chmod 600, root:root
ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
ANTHROPIC_AUTH_TOKEN=<你的 MiniMax key>
ANTHROPIC_MODEL=MiniMax-M3
ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M3
ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M3
ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M3
CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000     # M3 是 1M 上下文

key 怎么交给服务器

ssh myserver
mkdir -p /etc/devbox && chmod 700 /etc/devbox

cat > /etc/devbox/minimax.env <<'EOF'
ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
ANTHROPIC_MODEL=MiniMax-M3
ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M3
ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M3
ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M3
CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000
EOF

# key 单独追加，read -rs 让它不进 shell history
read -rs KEY && printf 'ANTHROPIC_AUTH_TOKEN=%s\n' "$KEY" >> /etc/devbox/minimax.env
unset KEY
chmod 600 /etc/devbox/minimax.env

§6git 凭证 × 离线运行 = 冲突

你选了 git 同步。那么当 agent 在你合盖之后想 git push 时，会发生什么？

SSH agent forwarding（ForwardAgent yes）只在你连着的时候有效。 你一合盖，forwarded socket 就没了。agent 执行 git push → 认证失败 → 要么报错，要么卡在密码提示上，然后一整晚什么都没干。

§7两个必须校准的预期

§8分阶段

Phase 0 — 侦察 只读

DEPLOYMENT.md 已经替我回答了一半：OS = Alibaba Cloud Linux 4，内核 6.6.102，磁盘 40G/22%，SELinux disabled，firewalld inactive，iptables INPUT ACCEPT。仍然未知的：

• 内存多大 —— 直接决定能并发跑几个 devbox
• 有没有 Docker；dnf 里有没有 docker-ce —— RHEL 系需要挂 CentOS/阿里云镜像仓库，不是一句 apt install
• 出网：api.minimaxi.com 与 api.minimax.io（两个都测，见 §5 坑一）、ghcr.io（Features）、registry-1.docker.io（镜像）。不再需要 api.anthropic.com。
• 从新加坡到 MiniMax 国内站的延迟 —— agent 的每一轮都要过这条链路，RTT 高会明显拖慢体验
• 是否需要配置阿里云镜像加速器

Phase 1 — 装 Docker 碰生产机

• 装前：curl -I https://jinghao.site/ + 假 token 测 acme-challenge，记录基线
• dnf 装 docker-ce（仓库需实测）；不开 TCP socket
• 装后：重跑同两条回归。iptables 被改动过，必须确认 nginx 与证书路径没受影响
• 建 /srv/dev/

Phase 2 — base 镜像 纯构建

devbox-base:latest：@anthropic-ai/claude-code、tmux（set -g mouse on）、git、ripgrep、fd、jq、gh。非 root 用户 dev，uid/gid 与宿主对齐。语言工具链一律不装 —— 交给各项目的 Features。

Phase 3 — devbox 脚本 + 验收 核心交付

Phase 4 — MiniMax 接入 你亲自做

见 §5「key 怎么交给服务器」。命令我给你，你自己执行，我不接触 key。之后 devcontainer.json 里只出现 --env-file /etc/devbox/minimax.env 这个路径，不出现 key 本身。

验收：容器里 claude -p "回复 OK" 能拿到 MiniMax 的响应；/status 显示的模型是 MiniMax-M3。

动手前先去 MiniMax 控制台确认计费模式（§5 坑三）。

Phase 5 — 配置与 hook 迭代

settings.json / CLAUDE.md / commands/ / agents/ 放进一个 git repo，容器启动时 symlink 进 ~/.claude/，可版本化。CLAUDE.md 里写死"不要 git push"（§6）。加 Stop hook 通知。

§9诚实清单：我现在还不知道的事

• 你的 MiniMax key 是国内站还是国际站的 —— 只有你能回答，决定 ANTHROPIC_BASE_URL 填哪个（§5 坑一）
• 从新加坡到 api.minimaxi.com 的连通性与延迟
• 你的 token plan 的计费模式与额度告警能力（§5 坑三）
• MiniMax-M3 在 Claude Code harness 里的工具调用可靠性 —— 只能靠你实际用出来，没有捷径（§5 坑二）
• 内存大小 → 并发 devbox 数量的上限
• docker-ce 在 Alibaba Cloud Linux 4 上的确切安装路径（仓库可能要手动加）
• 到 ghcr.io / registry-1.docker.io 的出网是否通畅
• VS Code Dev Containers 扩展是否真能复用 CLI 创建的容器 —— §4 的核心假设，Phase 3 验收②专门测它
• 装 Docker 对现有 nginx / iptables 的实际影响（理论上无害，必须实测）