Codex 安裝指南

Codex 是 OpenAI 開發的 AI 程式碼編輯器，基於 VSCode 建構，專注於提供卓越的程式碼補全和生成體驗，並完整支援 Superpowers 技能系統。

平台特色

Codex 是 OpenAI 在程式碼編輯領域的重要產品，提供：

• 🤖 GPT-4 整合：使用 OpenAI 最強大的語言模型
• 🔌 VSCode 深度整合：無縫融入 VSCode 開發環境
• 📝 智慧程式碼補全：基於語境的高準確度補全
• 🛠️ 強大重構能力：AI 輔助的程式碼重構和優化
• 📚 Superpowers 支援：完整技能生態系統整合

系統需求

硬體需求

• 處理器：x64_64 架構（ARM64 支援在測試中）
• 記憶體：至少 8 GB RAM（建議 16 GB 以上）
• 硬碟空間：至少 2 GB 可用空間

軟體需求

• 作業系統：
  • Windows 10/11（x64）
  • macOS 11+ (Big Sur 或更高版本)
  • Ubuntu 20.04+、Debian 11+、其他主流發行版
• 網路：穩定的網際網路連線
• VSCode：VSCode 1.70 或更高版本

安裝步驟

前置需求

# 第 1 步：安裝 VSCode
# 確保已安裝 VSCode
code --version

# 如果沒有安裝，訪問 https://code.visualstudio.com/

# 第 2 步：建立 OpenAI 帳號
# 訪問 https://platform.openai.com/
# 建立帳號並取得 API 金鑰

安裝 Codex 擴展

方法 1：透過 VSCode 市集安裝

# 在 VSCode 中
# 1. 開啟擴展面板
#    Ctrl+Shift+X (Windows/Linux)
#    Cmd+Shift+X (macOS)

# 2. 搜尋 "Codex"
#    在市集搜尋框中輸入 "Codex"

# 3. 選擇官方擴展
#    發行者：OpenAI
#    名稱：Codex

# 4. 點擊 "Install" 安裝

方法 2：透過命令列安裝

# 使用 code 指令安裝
code --install-extension OpenAI.codex

# 驗證安裝
code --list-extensions | grep codex

配置 Codex

# 第 1 步：開啟 Codex 設定
# File -> Preferences -> Settings
# 搜尋 "Codex"

# 第 2 步：設定 API 金鑰
# 在 settings.json 中加入
{
  "codex.apiKey": "sk-...",
  "codex.model": "gpt-4",
  "codex.temperature": 0.2
}

# 第 3 步：或使用環境變數
export OPENAI_API_KEY="sk-..."

Superpowers 整合

安裝 Superpowers 擴展

# 在 VSCode 中
# 1. 開啟擴展面板 (Ctrl+Shift+X)

# 2. 搜尋 "Superpowers for Codex"
#    或使用搜尋詞 "superpowers-codex"

# 3. 點擊 "Install"

# 4. 重啟 VSCode 以啟用整合

配置 Superpowers

Codex 中的 Superpowers 配置：

{
  "superpowers-codex.enabled": true,
  "superpowers-codex.apiKey": "your-anthropic-api-key",
  "superpowers-codex.model": "claude-fable-5",
  "superpowers-codex.fallbackModel": "gpt-4",
  "superpowers-codex.skillsPath": "~/.superpowers/skills",
  "superpowers-codex.contextFiles": [
    "README.md",
    "CLAUDE.md",
    "package.json"
  ]
}

使用方式

AI 聊天介面

Codex 提供內建的 AI 聊天功能：

// 開啟 AI 聊天面板
// 快捷鍵：Ctrl+Shift+O (Windows/Linux)
//          Cmd+Shift+O (macOS)

// 使用 Superpowers 技能
"使用 brainstorming skill 探索資料庫設計方案"

// Codex 會使用 Superpowers 系統回應

程式碼補全

使用 Codex 的智慧補全功能：

// 在編輯器中輸入
function calculateDiscount(price: number, userLevel: number) {
  // Codex 會根據 Superpowers 技能提供建議
  // 按下 Tab 接受建議

// 或觸發特定技能
// 在註解中加入：
/**
 * SUPERPOWERS: test-driven-development
 * 為此函式撰寫測試案例
 */

重構助手

使用 Codex 的 AI 重構功能：

# 選擇程式碼
# 按下 Ctrl+Shift+R (Windows/Linux)
#      Cmd+Shift+R (macOS)

# 選擇重構類型
# - "使用 Superpowers 技能重構"
# - 選擇 "test-driven-development"
# - Codex 會使用 TDD 方式重構程式碼

進階配置

自訂模型設定

{
  "codex.model": "gpt-4-turbo",
  "codex.fallbackModel": "gpt-3.5-turbo",
  "codex.temperature": 0.2,
  "codex.maxTokens": 2000,
  "codex.topP": 1,
  "codex.frequencyPenalty": 0
}

專案特定設定

// 在 .vscode/settings.json 中
{
  "codex.projectContext": {
    "language": "typescript",
    "framework": "react",
    "buildTool": "vite",
    "testFramework": "jest"
  },
  
  "superpowers-codex.projectSkills": {
    "primary": "test-driven-development",
    "secondary": ["verification-before-completion", "systematic-debugging"],
    "autoTrigger": {
      "onTest": "test-driven-development",
      "onDebug": "systematic-debugging",
      "onRefactor": "brainstorming"
    }
  }
}

工作區設定

# 在專案根目錄建立 .vscode 目錄
mkdir -p .vscode

# 建立 Superpowers 配置
cat > .vscode/superpowers.json << 'EOF'
{
  "enabled": true,
  "skills": ["all"],
  "context": {
    "include": ["src/**/*"],
    "exclude": ["node_modules/**", "dist/**"]
  },
  "triggers": {
    "onSave": "verification-before-completion",
    "onCommit": "requesting-code-review"
  }
}
EOF

開發流程整合

Git Hooks 整合

# 建立 git hooks
mkdir -p .git/hooks

cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# Codex 自動執行驗證
code --wait \
  --superpowers-skill verification-before-completion \
  --files $(git diff --cached --name-only)

if [ $? -ne 0 ]; then
  echo "驗證失敗，提交中止"
  exit 1
fi
EOF

chmod +x .git/hooks/pre-commit

CI/CD 整合

# GitHub Actions 整合
# .github/workflows/codex-review.yml

name: Codex AI Review
on: [pull_request]

jobs:
  superpowers-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '18'
          
      - name: Install VSCode
        run: |
          wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft.gpg
          echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list
          apt-get update
          apt-get install -y code
          
      - name: Install Codex
        run: code --install-extension OpenAI.codex --force
        
      - name: Run Superpowers Review
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          code --wait \
            --superpowers-skill requesting-code-review \
            --diff origin/main...HEAD \
            --output review-report.md
            
      - name: Upload Review
        uses: actions/upload-artifact@v2
        with:
          name: review-report
          path: review-report.md

常見問題

安裝問題

Q1: VSCode 無法安裝擴展

A:

# 檢查 VSCode 版本
code --version
# 需要至少 1.70 版本

# 檢查網路連線
ping api.openai.com

# 手動下載擴展
# 訪問 https://marketplace.visualstudio.com/items?itemName=OpenAI.codex
# 點擊 "Download" 手動下載 .vsix 檔案
# 使用 code --install-extension path/to/codex.vsix 安裝

Q2: API 金鑰無效

A:

# 驗證 API 金鑰格式
export OPENAI_API_KEY="sk-..."
echo $OPENAI_API_KEY | grep -E "^sk-"

# 檢查金鑰權限
# 確保金鑰有 GPT-4 API 存取權限

# 重新生成金鑰
# 訪問 https://platform.openai.com/api-keys

Q3: Superpowers 擴展無法載入

A:

# 檢查擴展相容性
code --list-extensions | grep superpowers

# 重新安裝 Superpowers
code --uninstall-extension superpowers-codex
code --install-extension superpowers-codex

# 重啟 VSCode
code --reload

配置問題

Q4: 技能回應很慢

A:

// 調整效能設定
{
  "codex.requestTimeout": 30000,
  "codex.maxTokens": 1000,
  "superpowers-codex.cache.enabled": true
}

// 使用較快的模型
{
  "superpowers-codex.model": "claude-opus-4-8"
}

Q5: 程式碼補全不準確

A:

// 調整模型參數
{
  "codex.temperature": 0.1,
  "codex.topP": 0.9,
  "codex.frequencyPenalty": 0.5
}

// 增加上下文
{
  "codex.contextLines": 10,
  "superpowers-codex.contextFiles": ["*"]
}

使用問題

Q6: 無法使用特定技能

A:

# 確認技能已安裝
ls -la ~/.superpowers/skills/

# 檢查技能路徑
echo $SUPERPOWERS_SKILLS_PATH

# 重新載入技能
# 在 VSCode 中按 Ctrl+Shift+P
# 搜尋 "Superpowers: Reload Skills"

Q7: 與其他 AI 工具衝突

A:

// 優先級設定
{
  "codex.priority": 10,
  "otherAI.priority": 5,
  "superpowers-codex.priority": 15
}

// 或停用衝突的擴展
code --disable-extension other-ai-extension

效能優化

快取策略

# 啟用 AI 回應快取
{
  "codex.cache.enabled": true,
  "codex.cache.maxSize": 1000,
  "codex.cache.ttl": 3600
}

並行處理

# 啟用並行補全
{
  "codex.parallel.enabled": true,
  "codex.parallel.maxSuggestions": 5
}

記憶體管理

# 限制上下文大小
{
  "codex.maxContextTokens": 8000,
  "codex.maxFileTokens": 2000,
  "superpowers-codex.maxContextFiles": 5
}

資源連結

官方資源

• OpenAI 平台：https://platform.openai.com
• Codex 文件：https://docs.openai.com/codex
• API 參考：https://platform.openai.com/docs
• GitHub：https://github.com/openai/codex

學習資源

• 官方教學：https://codex.openai.com/tutorials
• API 指南：https://platform.openai.com/docs/guides
• 範例專案：https://github.com/openai/codex-examples

社群資源

• OpenAI Discord：https://discord.gg/openai
• OpenAI 論壇：https://community.openai.com
• Stack Overflow：https://stackoverflow.com/questions/tagged/codex

下一步

安裝完成後，建議：

1. 設定環境：配置 API 金鑰和模型選項
2. 安裝 Superpowers：安裝並配置技能系統
3. 探索功能：嘗試程式碼補全和重構功能
4. 建立專案配置：為專案建立 .vscode/superpowers.json
5. 學習技能：探索 brainstorming 和其他技能

開始使用 Codex 和 Superpowers，體驗 OpenAI 最強大的程式碼 AI 能力！