把 Codex 關在開發容器,開完整權限也不會動到系統檔

更新

摘要

用 VS Code 的 Dev Containers 把 Codex 放進 Docker 容器執行,開 Full Access 也碰不到容器外的系統檔與其他資料夾。掛載進容器的專案仍然可能被改壞,要靠 Git 復原。

文章目錄

把 Codex 放進開發容器後,開 Full Access 讓它直接執行指令,影響範圍只到容器和掛載進去的專案。容器外的檔案它看不到,就算下錯指令,也刪不到 Windows C 槽的系統檔或電腦上的其他專案。掛載進去的專案仍然可能被改壞,這部分要靠 Git 復原。

開發容器(Dev Container)是用 Docker 容器當開發環境,VS Code 透過 Dev Containers 延伸模組連進容器裡寫程式,IntelliJ 也有類似的功能。

本文以 VS Code、Docker Desktop 與 Ubuntu 開發容器為範圍,建立流程依照 VS Code Dev Containers 官方文件。Windows 要先能正常啟動 WSL2 與 Docker Desktop,macOS 則要確認 Docker Desktop 已在執行,再開始建立容器。

安裝容器功能

先在 VS Code 安裝 Dev Containers 與 Remote Explorer,再從左側遠端總管的開發容器點擊「安裝 Docker」,VS Code 會自動下載並安裝 Docker Desktop。

VS Code 遠端總管的開發容器面板,提示可從安裝 Docker 開始使用容器

Docker Desktop 於 macOS 可以直接安裝使用,Windows 則要先啟用 WSL。安裝完成後啟動 Docker Desktop,再重新開啟 VS Code。

macOS Docker 安裝視窗,將 Docker.app 拖曳到 Applications 資料夾

建立開發容器

現有的專案或新建的專案都可以拿來實驗。從遠端總管的開發容器點擊「開啟容器中的資料夾」,選擇專案資料夾。

VS Code 遠端總管的開發容器面板,顯示開啟容器中的資料夾按鈕

專案還沒有開發容器的設定時,會跳出新增開發容器設定檔的選單,選擇「將設定新增至工作區」。

VS Code 新增開發容器設定檔選單,選擇將設定新增至工作區

先選擇基底 Image,我習慣用 Ubuntu,該有的都有,很適合開發用。

VS Code 新增開發容器設定檔清單,選擇 Ubuntu devcontainers 範本

版本使用預設值 resolute (Ubuntu 26.04)。

VS Code Ubuntu 版本選單,使用預設的 resolute 版本

接著可以讓容器預先裝好開發工具,換電腦時也能用同一份設定重建。我的專案是 Android App,所以勾選 Android SDK。

VS Code Dev Containers 選取功能畫面,勾選 Android SDK Feature

我用 Codex CLI 開發,所以也一起勾選。按下確定後,VS Code 會開始下載與建置開發容器,需要等一段時間。

VS Code Dev Containers 選取功能畫面,同時勾選 Codex CLI Feature

設定容器工具版本

容器建置好後,VS Code 會自動連進開發容器。Android 專案要求各元件的版本號碼和專案設定一致,所以要另外指定版本。

剛才選用的 Android SDK Feature 提供 platform 與 build_tools 兩個版本欄位,編輯 .devcontainer/devcontainer.json,在 android-sdk 底下加入版本設定。

VS Code 開發容器內的 devcontainer.json,設定 Android SDK platform 與 build_tools 版本

設定完成後點擊左下角的「開發容器: Ubuntu @ XXXX」按鈕,選擇「重建容器」,重建完成後 Android SDK 的版本就會和專案設定相同。

VS Code 開發容器命令選單,選擇重建容器

登入 Codex CLI

環境準備好後,在 VS Code 的終端機輸入 codex 啟動 Codex CLI 並登入。

Codex CLI 登入畫面,提供 ChatGPT、Device Code 與 API key 登入選項

登入後輸入 /permissions 把權限改成 Full Access,Codex 就能直接執行指令,不再每一步詢問。

Codex CLI 權限設定畫面,選擇 Full Access 讓 Agent 在容器內完整存取

確認容器真的可以工作

VS Code 左下角應顯示目前連線的開發容器,在終端機執行 cat /etc/os-release 會看到所選的 Ubuntu 版本,輸入 codex 也能進入登入後的 Session。Android 專案再跑一次既有的建置,確認 platform、build_tools 符合專案需求,容器能啟動不代表工具鏈已經裝齊。

Full Access 能碰到哪些檔案

Codex 在容器裡開 Full Access,能讀寫的只有容器本身和掛載進來的資料夾。電腦上的 Windows 或 macOS 系統檔、其他專案與個人資料都不在容器裡,Codex 刪不到。

掛載進來的專案資料夾是直接對應到電腦上的同一份檔案,Codex 刪掉或改壞的程式碼,電腦上的專案也會跟著變。如果另外掛載了憑證、Docker Socket 或其他目錄,Codex 一樣能存取。依照 VS Code 的說明,Dev Containers 預設也會把本機的 SSH agent 與 Git 設定帶進容器,Codex 能用它們推送到遠端的 Repository。

.git 資料夾也在掛載的專案裡,Codex 一樣能改動,還沒 Commit 的修改也沒有備份。改壞時要能還原,靠的是已經 Commit 並推送到遠端的版本。

建置失敗與回到本機

修改 .devcontainer/devcontainer.json 後沒有生效時,先執行「Dev Containers: Rebuild Container」。直接在容器裡手動安裝的套件,重建後就會消失,要保留的工具寫進 Feature、Dockerfile 或 postCreateCommand。

容器建置失敗時,從「Dev Containers: Show Container Log」查看失敗的步驟,再選擇「Open Folder Locally」回到本機修改設定。不再使用開發容器時,回到本機開啟專案,刪除 .devcontainer 資料夾即可,專案的程式碼一直存在電腦上,不會跟著容器消失。

總結

我的工作主力是 Codex,它的權限管理還在快速改版,目前的版本不太好用,直接給完整權限又不安全。放進開發容器後開 Full Access,影響範圍只剩掛載進去的專案,改壞了再用推送到遠端的 Git 版本復原。

延伸閱讀

Ted Liou

Ted Liou

現役軟體工程師,分享 Unity 與 AI 的技術開發經驗。

留言