Claude Code 2.0.41-2.0.47 版本更新日誌

📋 版本總覽

本文整理了 Claude Code 2.0.41 至 2.0.47 版本的重要更新內容，涵蓋六個版本的新功能、改進優化和問題修復。

🎯 重點更新

✨ PermissionRequest Hook：自動化權限審批機制
☁️ Azure AI Foundry 支援：新增雲端平台整合
🔧 Subagent Hooks 增強：更完整的生命週期控制
🚀 背景任務傳送：支援 Web 版背景執行
🐛 大量 Bug 修復：提升穩定性和使用體驗

✨ 新增功能

1. PermissionRequest Hook（v2.0.45）

新增的 PermissionRequest Hook 允許您使用自訂邏輯自動批准或拒絕工具權限請求，大幅提升自動化工作流程的效率。

graph TD
    A[工具請求權限] --> B{PermissionRequest Hook}
    B -->|自動批准| C[執行工具]
    B -->|自動拒絕| D[停止執行]
    B -->|無 Hook 設定| E[詢問使用者]

    style A fill:#e1f5fe
    style C fill:#c8e6c9
    style D fill:#ffcdd2
    style E fill:#fff3e0

使用場景：

對特定工具或路徑自動授權
限制敏感操作需手動確認
建立分層權限管理策略

設定範例：

// .claude/hooks/permission-request.ts
export default async function({ tool, parameters }) {
  // 自動批准讀取操作
  if (tool === 'Read' && parameters.file_path.startsWith('/safe/')) {
    return { approved: true };
  }

  // 拒絕敏感檔案的寫入
  if (tool === 'Write' && parameters.file_path.includes('secret')) {
    return { approved: false, reason: '敏感檔案禁止修改' };
  }

  // 其他情況交由使用者決定
  return { approved: null };
}

💡 延伸閱讀：Hooks 系統與遷移指南

2. Azure AI Foundry 支援（v2.0.45）

Claude Code 現已支援 Azure AI Foundry 平台！您可以在 Azure 雲端環境中使用 Claude 模型。

快速開始：

在 Azure AI Foundry 中設定 Claude 模型端點
配置 Claude Code 的 Azure 認證
透過標準 CLI 或 API 使用

📘 官方文件：Azure AI Foundry 設定指南

3. Subagent Hooks 增強（v2.0.42 & v2.0.43）

v2.0.42：SubagentStop Hook 新增欄位

interface SubagentStopHookInput {
  agent_id: string;              // 新增：代理 ID
  agent_transcript_path: string; // 新增：完整對話記錄路徑
  // ... 其他現有欄位
}

v2.0.43：新增 SubagentStart Hook

// 在子代理啟動時觸發
export default async function(input: SubagentStartHookInput) {
  console.log(`子代理 ${input.subagent_type} 已啟動`);
  // 可用於記錄、監控或初始化設定
}

應用價值：

完整追蹤子代理生命週期（Start → Stop）
存取完整對話記錄進行分析
實作代理層級的監控和日誌

💡 延伸閱讀：Subagents 與 Plan Mode

4. 背景任務傳送到 Web 版（v2.0.45）

在訊息開頭加上 & 符號，即可將背景任務傳送到 Claude Code Web 版執行。

# 在 CLI 輸入
& 執行長時間的資料處理任務

# 任務將在 Web 版背景執行，CLI 可繼續其他工作

適用場景：

長時間運行的測試或建置
大型程式碼庫分析
需要持續監控的任務

🔧 改進優化

Hook 系統改進

v2.0.41：Prompt-based Stop Hooks 支援自訂模型

# .claude/settings.json
{
  "hooks": {
    "stop": {
      "model": "haiku"  # 新增：可指定 Hook 評估使用的模型
    }
  }
}

v2.0.43：新增 tool_use_id 欄位

interface PreToolUseHookInput {
  tool_use_id: string;  // 新增：唯一工具呼叫識別碼
  // ...
}

v2.0.43：SDK 支援自訂 Timeout

// 自訂 Hook 執行逾時時間
{
  "hooks": {
    "timeout": 30000  // 30 秒
  }
}

Skills 系統改進（v2.0.43）

新增 skills 前置聲明欄位，可為子代理自動載入指定的 Skills：

# custom-agent.yaml
skills:
  - pdf-processor
  - data-analyzer

好處：

減少重複配置
確保子代理擁有必要能力
提升任務執行效率

權限與安全改進（v2.0.41）

擴充免審批的安全 Git 命令清單，減少不必要的權限提示：

# 以下命令無需使用者批准即可執行
git add
git rm
git submodule
# ... 及其他安全操作

自訂代理權限模式（v2.0.43）

新增 permissionMode 欄位，允許為自訂代理設定權限策略：

# custom-agent.yaml
permissionMode: "auto"  # 選項：auto, ask, deny

🐛 Bug 修復

v2.0.41

✅ 修復使用者設定的斜線命令被載入兩次，導致渲染問題
✅ 修正命令描述中使用者設定與專案設定的錯誤標籤
✅ 修復外掛命令 Hook 執行逾時時的崩潰問題
✅ 修正 Bedrock 使用者使用 --model haiku 時看到重複 Opus 選項的問題
✅ 修復信任對話框和新手引導中損壞的安全文件連結
✅ 修正按 ESC 關閉差異模態框時也會中斷模型執行的問題
✅ ctrl-r 歷史搜尋停在斜線命令時不再取消搜尋

v2.0.43

✅ 修復 @-mention 檔案時巢狀 CLAUDE.md 未載入的問題
✅ 修正某些訊息在 UI 中重複渲染的問題
✅ 修復部分視覺閃爍問題
✅ 修正 NotebookEdit 工具在 cell ID 符合 cell-N 模式時插入位置錯誤的問題

v2.0.45

無新增 Bug 修復（主要為功能新增版本）

v2.0.46

✅ 修復當圖片格式無法從元資料偵測時，回報錯誤媒體類型的問題

v2.0.47

✅ 改進 claude --teleport 的錯誤訊息和驗證
✅ 改進 /usage 命令的錯誤處理
✅ 修復歷史記錄在退出時未記錄的競爭條件
✅ 修正從 settings.json 套用 Vertex AI 配置的問題

💡 最佳實踐建議

1. 善用 PermissionRequest Hook

建議配置策略：

// 分層權限管理
export default async function({ tool, parameters }) {
  // 第一層：完全信任的路徑
  if (isTrustedPath(parameters.file_path)) {
    return { approved: true };
  }

  // 第二層：唯讀操作
  if (isReadOnlyTool(tool)) {
    return { approved: true };
  }

  // 第三層：需人工確認
  return { approved: null };
}

2. 監控 Subagent 生命週期

利用新增的 Hook 欄位實作完整監控：

// SubagentStart Hook
export default async function(input) {
  await logStart(input.subagent_type, input.agent_id);
}

// SubagentStop Hook
export default async function(input) {
  await logStop(input.agent_id);
  await analyzeTranscript(input.agent_transcript_path);
}

3. 升級注意事項

📌 檢查是否使用已棄用的 Output Styles（參考 v2.0.30 遷移指南）
📌 更新 Hook 實作以利用新增的欄位（agent_id、tool_use_id 等）
📌 若使用 Azure，請參考官方文件完成設定
📌 測試 PermissionRequest Hook 確保權限邏輯正確

🔗 相關資源

官方文件

系列文章

📝 總結

2.0.41-2.0.47 版本帶來了實用的權限管理自動化（PermissionRequest Hook）、雲端平台擴充（Azure AI Foundry）、以及大量穩定性改進。建議所有使用者升級至最新版本，並探索新的 Hook 功能以優化工作流程。

升級建議：

# 更新至最新版本
claude update

如有任何問題或建議，歡迎參考官方文件或在社群中討論！