Codex 課前環境準備：安裝 Git、Python、VS Code 與開發工具

Codex 執行任務時，使用的是你電腦上現有的環境與工具。若要讓它替你處理資料、執行腳本或管理檔案版本，電腦需預先準備好對應的執行環境。

建議安裝工具清單

類別	工具	用途
核心必裝	Git	記錄檔案變更，提供版本回滾與差異比對
	Python	執行資料清理、問卷統計、訪談分析與圖表繪製
	VS Code	檢視專案目錄、檢查 Codex 修改的檔案與輸出
建議安裝	Node.js	執行前端工具或建置成果展示網站
	uv	快速建立與管理各專案獨立的 Python 虛擬環境
	GitHub Desktop	若不習慣 command line，可用圖形介面操作 Git
進階選配	Pandoc / Quarto	產出可重現的研究報告、轉換 Markdown 至 Word / PDF

直接複製給 AI 安裝

若想直接讓 AI（如 Codex）自動安裝，可複製以下指令貼入對話框：

請檢查我這台電腦是否已安裝以下工具，若缺少請依我的作業系統（Windows / macOS）協助安裝：
1. Git
2. Python 3
3. Visual Studio Code
4. Node.js (LTS)
5. uv

安裝完成後請執行版本檢查指令回報。

手動安裝：Windows

Windows 10 / 11 建議使用內建的 winget 一鍵安裝。

1. 開啟 PowerShell 並安裝核心工具

在開始選單搜尋 PowerShell 開啟，貼上以下指令：

winget install --id Git.Git -e
winget install --id Python.Python.3.13 -e
winget install --id Microsoft.VisualStudioCode -e
winget install --id OpenJS.NodeJS.LTS -e

2. 安裝 uv 與 GitHub Desktop（選用）

# 安裝 uv (Python 套件與環境管理)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 安裝 GitHub Desktop (圖形介面 Git)
winget install --id GitHub.GitHubDesktop -e

3. 驗證安裝

關閉並重新開啟 PowerShell，執行以下指令確認版本：

git --version
python --version
node --version
code --version
uv --version

若 winget 因學校或公司權限無法使用，請至各軟體官網下載 .exe 安裝檔安裝。

手動安裝：macOS

macOS 建議使用套件管理工具 Homebrew。

1. 開啟 Terminal 並安裝 Command Line Tools 與 Homebrew

按 Command + Space 搜尋 Terminal 開啟，依序執行：

# 1. 安裝 Command Line Tools
xcode-select --install

# 2. 安裝 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝過程若要求輸入 Mac 密碼，輸入時畫面上不會顯示星號，直接按 Return 即可。完成後依終端機提示將 brew 加入環境變數。

2. 安裝工具

brew install git python node uv
brew install --cask visual-studio-code github

3. 驗證安裝

重啟 Terminal 後執行：

git --version
python3 --version
node --version
code --version
uv --version

建立測試專案確認環境

環境準備完成後，可建立一個空白資料夾驗證工具調用：

test-project/
└─ README.md

在 Codex 對話框中輸入：

請檢查目前環境中的 Git、Python 與 VS Code 是否可用，將各工具版本寫入 README.md，不要修改其他系統設定。

若 Codex 能成功讀取資料夾並更新 README.md，即表示環境已就緒。下一篇將介紹如何建立第一個正式的研究專案。

參考資料

7 筆