載入中

使用 Claude Code 建構

第 13 課5 分鐘
載入中

使用 Claude Code 建構

手動撰寫呼叫 Claude API 的程式碼完全沒問題,但還有一條更快的路徑: 讓 Claude 為您撰寫程式碼。在本課程中,我們將使用 Claude Code 從一個已建立骨架的檔案中填入 API 整合—— 使用您在本課程中學到的相同基本元件。

從骨架開始

這個專案很簡單:一個取得天氣資訊的 TypeScript 檔案。它包含兩個骨架函式:

  • getWeather — 接受一個城市名稱,並回傳溫度和天氣狀況。
  • run — 一個應該使用工具執行器(tool runner)和 Claude TypeScript SDK 的函式。

工具執行器是為您處理工具呼叫和代理迴圈的部分,因此您不必手動接線。

Claude API 技能

Claude Code 內建了一個名為 Claude API 的技能。您可以直接使用 /claude-api 來呼叫它,或者當 Claude Code 偵測到您正在使用 TypeScript SDK 時,它會自動呼叫該技能。

一個提示,可運作的程式碼

在終端機中開啟專案資料夾並啟動 Claude Code。

從那裡開始,只需要一個提示。一個好的提示會做三件事:

  • 指名您想要變更的檔案。
  • 指名您想要使用的模式。
  • 指名您期望的最終狀態。

接著 Claude Code 會根據型別填入 getWeather 和 run,在檔案底部附加一個呼叫,執行該腳本,並回報輸出結果。如果發生錯誤,它會讀取錯誤訊息並就地修補程式碼。

Claude Code 在終端機中讀取 weather.ts 和工具執行器檔案,在收到提示後的畫面

Claude Code 產生的結果

在這次執行中,Claude Code 建立了一個Zod 工具,它會解析輸入並根據城市類型回傳輸出。它還建立了我們要求的工具執行器和 run 函式,並印出代理迴圈的最終結果。

Claude Code 在終端機中生成天氣程式碼,可看到 betaZodTool 匯入和硬編碼的城市資料

需要記住的模式

您針對 Claude API 撰寫的大部分程式碼都有一個熟悉的形狀:

  1. 定義一個工具。
  2. 將它交給一個執行器。
  3. 回傳結果。

您不需要每次都憑記憶輸入這些內容。相反地,建立檔案骨架,交給 Claude Code,然後只需審查差異(diff)即可。

回顧

  • Claude Code 是一個在您的終端機內編輯檔案並執行命令的代理。
  • 內建的 Claude API 技能會在 Claude Code 偵測到 TypeScript SDK 時自動載入,或者您可以使用 /claude-api 來呼叫它。
  • 給它一個指名檔案、模式和最終狀態的提示——它會撰寫程式碼、執行它,並就地修正錯誤。
  • Claude API 程式碼遵循一個熟悉的形狀:定義一個工具,交給一個執行器,回傳結果。建立骨架、委派、審查差異。