Codex Claude Workstation
产品介绍
浏览器可访问的 Codex AI 编程工作站，集成 code-server (VS Code) 和丰富的开发工具链。
主要功能
- code-server (VS Code) — 浏览器内完整 VS Code 体验
- Codex CLI — OpenAI Codex AI 编程助手
- Claude Code — Anthropic Claude Code CLI
- 开发工具链 — Go, Rust, Bun, Docker CLI, yq, gh, shellcheck 等 30+ 工具
- 代理支持 — 通过 supervisord 按需启用 Clash.Meta/sing-box/Xray
Introduction
Browser-accessible Codex AI development workstation with code-server (VS Code) and rich dev toolchain.
Features
- code-server (VS Code) — Full VS Code experience in browser
- Codex CLI — OpenAI Codex AI coding assistant
- Claude Code — Anthropic Claude Code CLI
- Dev Toolchain — Go, Rust, Bun, Docker CLI, yq, gh, shellcheck, 30+ tools
- Proxy Support — On-demand Clash.Meta/sing-box/Xray via supervisord
安装说明
镜像由 codex-claude-workstation-builder 预先编译，发布在：
ghcr.io/okxlin/codex-claude-workstation:latest
1Panel 安装时自动拉取，无需手动构建。
参数填写指南
必填参数
PANEL_APP_PORT_HTTP — Web 访问端口
- code-server 对外暴露的访问端口
- 默认
8080，可改为任意未占用端口 - 安装后通过
http://你的IP:此端口访问
CODE_SERVER_PASSWORD — code-server 密码
- 登录 code-server 时使用的密码
- 默认
change-me，请务必修改
ROOT_PASSWORD — Root 用户密码
- 容器 root 用户的密码（可通过
su - root切换登录） - 默认
codex2024，建议修改为更强的密码
APP_DATA_DIR — 数据目录
- 工作区文件存放的宿主机目录
- 默认
./data，建议填写绝对路径如/data/codex-workstation
可选参数
DOCKER_SOCK_SRC — Docker 套接字路径
- 挂载宿主机 Docker Socket 到容器内
/var/run/docker.sock - 默认
/var/run/docker.sock，保留容器内 Docker CLI 控制宿主 Docker 的能力 - 留空时会挂载
/dev/null到容器内 Docker Socket 位置，相当于禁用宿主 Docker - 启动时会自动把
dev加入 Docker Socket 的宿主 GID；若宿主权限策略阻止，可使用sudo docker - 启用 Docker Socket 后，容器内进程基本具备宿主 Docker 控制权；使用第三方 LLM 中转站且不需要宿主 Docker 时，建议主动留空禁用
TZ — 时区
- 默认
Asia/Shanghai - 可选，留空使用系统默认
FIX_WORKSPACE_OWNERSHIP_RECURSIVE — 工作区递归权限修复
- 默认
false，启动时只修复/workspace目录本身的 ownership - 可填
false或true - 如果历史数据里已有 root-owned 子文件，可临时设为
true后重启一次容器
CUSTOM_ENV_FILE — 自定义环境变量文件
- 默认
./data/custom.env - 会以 Docker Compose
env_file形式注入容器，适合后续追加 VPS 测试服务、临时接口地址、项目专用变量等 - 文件不存在时安装/升级脚本会自动创建；每行格式为
KEY=value - 1Panel 表单中的显式变量优先级高于
CUSTOM_ENV_FILE中的同名变量
GITHUB_TOKEN — GitHub Token
- 可选，用于容器内 GitHub CLI、私有仓库拉取或 Git 相关自动化
- 建议只授予所需最小权限
GIT_AUTHOR_NAME / GIT_AUTHOR_EMAIL — Git 作者信息
- 可选，传入容器作为 Git author 环境变量
GIT_COMMITTER_NAME / GIT_COMMITTER_EMAIL — Git 提交者信息
- 可选，传入容器作为 Git committer 环境变量
不在安装表单中的参数
PROXY_ENABLED — 代理 (手动启用)
- 默认不启动；内置 clash-meta / sing-box / xray 二进制
- 通过
supervisorctl start clash-meta|sing-box|xray按需启用 - 代理配置文件放入
/home/dev/proxy/（持久化），如clash-meta.yaml/sing-box.json/xray.json
访问说明
安装完成后通过分配的端口访问：
http://IP:端口— code-server (VS Code)，集成终端在 VS Code 内使用
首次登录
安装完成后进入容器执行 Codex 登录：
docker exec -it ${CONTAINER_NAME} bash
codex login --device-auth
Codex 沙箱要求
Codex CLI 的默认沙箱依赖 Linux unprivileged user namespace。应用的 docker-compose.yml 已包含 seccomp=unconfined 和 apparmor=unconfined，宿主机仍需允许 user namespace：
sudo sysctl -w kernel.unprivileged_userns_clone=1
sudo sysctl -w user.max_user_namespaces=15000
如果 Codex 报 bwrap: No permissions to create a new namespace，请先检查宿主机上述 sysctl，再在容器内运行 doctor.sh。
认证说明
code-server 密码认证（单层）：
- code-server 密码 — VS Code 登录时使用的密码
数据持久化
| 数据 | 路径 | 持久化方式 |
|---|---|---|
| 工作区 | /workspace |
绑定挂载到数据目录 |
| Codex 配置 | /home/dev/.codex |
Named volume codex-home |
| Claude 配置 | /home/dev/.claude |
Named volume codex-home |
| 代理配置 | /home/dev/proxy/ |
Named volume codex-home |
| code-server 配置 | /home/dev/.config/code-server/ |
Named volume codex-home |
| code-server 扩展 | /home/dev/.local/share/code-server/extensions/ |
Named volume codex-home |
| npm/pipx/uv 用户工具 | /home/dev/.local/ |
Named volume codex-home |
| Go 用户工具 | /home/dev/go/bin/ |
Named volume codex-home |
| Rust 用户工具 | /home/dev/.cargo/bin/ |
Named volume codex-home |
| Bun/Deno 用户工具 | /home/dev/.bun/, /home/dev/.deno/ |
Named volume codex-home |
安装脚本会预创建 ${APP_DATA_DIR}/workspace，并将其 ownership 设置为容器内 dev 用户的 1001:1001。
容器内 npm install -g <pkg> 默认安装到 /home/dev/.local，重建容器后会保留。
注意事项
- 不支持 Chat Completions-only API（必须支持 OpenAI Responses API）
- 首次安装后需在 code-server 终端执行
codex login认证 - 不默认启动 Codex App Server
- 容器以
dev用户运行（非 root），可通过 ROOT_PASSWORD 切换至 root - 代理默认不启动，按需通过
supervisorctl start clash-meta|sing-box|xray启用 - 使用第三方 LLM provider 或中转站时，不要让模型直接处理未脱敏的密钥、token、私有配置；保留或启用 Docker Socket 前请确认你接受宿主 Docker 控制权暴露给容器内工具链的风险