← All posts

從「寫程式」到「改程式」:Claude Agent SDK 深度解析

從「對話」走向「行動」!Anthropic 正式推出 Claude Agent SDK。 別再把 AI 當作單純的聊天機器人了。本篇文章深度解析 Claude Agent SDK 如何將底層的開發能力(如讀寫檔案、執行 Bash 指令、精準修改程式碼)直接賦予開發者。透過「自主循環」與「MCP 協議」的整合,AI 代理人現在能像真正的工程師一樣,在你的專案中自主完成 Bug 修復與架構重構。 我們將探討 SDK 的核心技術亮點、三步快速上手流程,以及為何從「Code」更名為「Agent」背後隱藏的發展野心。如果你正想打造自己的 AI 助手,這篇實戰指南不容錯過。

從「寫程式」到「改程式」:Claude Agent SDK 深度解析

身為軟體開發者,我們都見證了 AI 從單純的「程式碼生成器」演變成能處理整個專案的「AI 工程師」。近日 Anthropic 推出的 Claude Agent SDK,正式將其旗艦工具 Claude Code 的核心技術開放給所有開發者。

這不只是一個 API,而是一個能讓 AI 直接操作電腦 的完整開發框架。

核心重點:Claude Agent SDK 到底強在哪?

以往我們使用 Anthropic API,需要自己寫「迴圈」來處理 Tool Use:AI 說要讀檔、我們讀檔給它、AI 根據內容寫程式、我們再把程式存檔。

Claude Agent SDK 直接終結了這種繁瑣的開發模式:

內建「九大工具」:SDK 自帶了 Read (讀檔)、Write (存檔)、Edit (精準修改)、Bash (執行指令)、Grep (搜尋內容) 等工具。你不需要自己寫任何檔案 IO,AI 直接就能操作你的目錄。

自主循環(Autonomous Loop):你只要給出目標(Prompt),SDK 會自動進入「觀察-行動-驗證」的循環,直到任務完成。

MCP 協議原生支援:完美串接 Model Context Protocol (MCP),讓 Agent 能輕鬆連接 GitHub、資料庫或瀏覽器。

如何執行:快速上手三步驟

想要在你的專案中導入 Claude Agent,執行方式非常直覺:

第一步:安裝 SDK

Bash

npm install @anthropic-ai/claude-agent-sdk

# 或 Python 版本

pip install claude-agent-sdk

第二步:初始化 Agent

你只需要定義一個簡單的查詢(Query),並列出你「准許」AI 使用的工具清單。

TypeScript

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {

const result = await query({

prompt: "找出專案中所有的 TODO 註解,並依照優先級修復它們",

options: {

  allowedTools: \["Read", "Edit", "Grep", "Bash"\], // 授權 AI 操作權限

}

});

}

第三步:監控與掛鉤 (Hooks)

你可以使用 SDK 提供的 Hooks 功能。例如在 AI 執行 Bash 指令前,先彈出視窗請求你的許可,或者在 AI 修改程式碼後自動觸發 Lint 檢查。

後續發展方向:AI Agent 的未來

影片與官方文件指出,這套 SDK 的野心不只是「Coding」:

從「Coding SDK」轉向「Agent SDK」:Anthropic 已經將名稱從 Code SDK 改為 Agent SDK,這暗示未來它將支援更多非開發類型的工具(如網頁爬取、郵件管理、財務分析)。

多代理協作 (Sub-agents):你可以建立一個「主工程師 Agent」,它會自動派發任務給專門負責「測試」與「文檔寫作」的子 Agent。

與 IDE 深度整合:未來我們將看到更多基於此 SDK 開發的 VS Code 或 JetBrains 插件,讓 AI 代理人直接駐紮在你的開發環境中進行背景作業。

結語:工程師的角色正在改變

當 Claude Code 和 SDK 讓「1 萬行程式碼的搬遷」在幾天內完成時,我們的工作重心將從「打字寫程式」轉向「架構設計與代理人調度」。

如果你已經厭倦了手動搬運程式碼到 Web 介面,現在就是開始使用 Claude Agent SDK 的最佳時機。