---
title: "使用 Claude Code、Codex 或 Cursor 進行開發"
description: "安裝 ThunderPhone Agent Skills、連接 ThunderPhone MCP 伺服器，並為編碼智能體提供最新產品文件。"
---

ThunderPhone 為編碼智能體提供三個層次：

| 層次 | 為智能體提供的功能 |
| --- | --- |
| [Agent Skills](https://github.com/thunderphone/skills) | 涵蓋智能體、提示、電話號碼、通話、工具、webhook、知識庫、測試、活動、小工具、即時框架及遷移的專門程序。 |
| MCP | 已驗證的工具涵蓋智能體、電話號碼、通話、測試、知識庫、工具／webhook、活動、語音、匯入及文件，並會隨推出逐步增加；呼叫 `tools/list` 取得即時目錄。 |
| [原始文件](https://thunderphone.com/docs/llms.txt) | 提供產品行為及 API 詳情的最新 Markdown 原始檔。 |

Skills 說明如何完成工作。MCP 讓編碼智能體檢查並操作你的組織。原始文件則為已載入 Skill 以外的問題提供參考資料。

## 在專案中安裝

此區塊會安裝 Skills、讓目前 shell 可使用金鑰，並將專案範圍的 MCP 伺服器加入 Claude Code。請從你的密鑰管理工具讀取實際值來取代預留位置；不要將金鑰貼到儲存庫或聊天室中。

```bash
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp
```

如使用 Codex，請以以下指令取代最後一行指令：

```bash
codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY
```

Cursor 會從 `.cursor/mcp.json` 讀取專案設定：

```json
{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

VS Code 會在 `.vscode/mcp.json` 中的 `servers` 金鑰下使用相同伺服器：

```json
{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

<Warning>
  組織 API 金鑰可讀取組織資料及執行已啟用的操作。請將其儲存於密鑰管理工具中，將存取範圍限制於目標專案，並在批准前檢查會變更資料的工具呼叫。
</Warning>

## 範例工作階段：雙語牙科診所接待員

1. 要求編程智能體載入 `create-agent`、
   `thunderphone-prompt-builder`、`build-tool-integration`、`add-knowledge` 及
   `test-agent`。指示它先制定計劃，暫時不要建立資源。
2. 向它提供已核實的診所資料、支援的任務、升級處理規則及兩種所需語言地區設定。要求它檢查即時語音目錄及支援語言，而非自行虛構語音或語言地區設定。
3. 要求它根據通用原則及資料建立一個正式環境提示。智能體應切換至來電者支援的語言、保持簡潔語音、每次只問一條問題，並避免預設來電者回應的腳本。
4. 要求它定義一個範圍明確的預約工具，並只附加接待員所需的知識。部署前測試工具成功、沒有可用時段、無效輸入、逾時及轉交真人處理。
5. 為兩種語言、打斷、修正、資料缺失、知識問題、預約失敗及升級處理產生情境。執行測試、檢查逐字稿及工具證據、修正最小範圍的通用規則，然後重新執行同一組測試。
6. 檢閱確切草稿及測試證據，然後明確授權部署及附加電話號碼。轉移真實流量前，以每種語言進行一次受控音訊通話。

使用 [Python 或 TypeScript SDK](/api-reference/sdks) 提交具類型的 REST 請求。

當建立工作需要可預測的負載、版本化測試資料、大量編排，或需要目前 MCP 工具清單未提供的操作時，請使用 REST 而非 MCP。API 起點為 `https://api.thunderphone.com/v1`；請參閱
[API 簡介](/api-reference/introduction) 及
[MCP 指南](/yue/guides/thunderphone-mcp-server)。