初始設定

在這個範例中，我們將讓 Claude 編寫一個 Python 函數來檢查字串是否為回文。

​

前置需求

您需要：

• 一個 Anthropic Console 帳戶
• 一個 API 金鑰
• Python 3.7+ 或 TypeScript 4.5+

Anthropic 提供 Python 和 TypeScript SDK，不過您也可以直接向 API 發送 HTTP 請求。

​

從 Workbench 開始

無論您要執行什麼特定任務，任何 API 呼叫都會向 Anthropic API 發送一個配置完善的提示。在學習如何充分利用 Claude 時，我們建議您從 Workbench（一個基於網頁的 Claude 介面）開始開發過程。

登入 Anthropic Console 並點擊 Workbench。

在中間部分的 User 下方，讓我們向 Claude 提出一個問題。

為什麼海水是鹹的？

點擊 Run。在右側，您會看到類似這樣的輸出：

海水之所以鹹，是由於幾個因素：

1. 岩石風化：數百萬年來，雨水、河流和溪流侵蝕含有礦物鹽的岩石。這些鹽分通過水流被帶入海洋。
2. 火山活動：海底火山和熱液噴口將礦物質（包括鹽分）釋放到海水中。
3. 大氣沉降：海水噴霧中的鹽分顆粒可以被風帶走並重新沉積到海洋中。
4. 蒸發：當水從海面蒸發時，會留下溶解的鹽分，增加剩餘水中的鹽分濃度。
5. 生物過程：某些海洋生物在代謝過程中會釋放鹽類化合物，從而影響海水的鹹度。

隨著時間推移，這些過程不斷向海洋添加鹽分，而蒸發則帶走純水，導致海洋目前的鹹度水平。值得注意的是，海洋中的總鹽分含量保持相對穩定，因為鹽分的輸入與通過蒸發沉積物形成等過程的鹽分移除達到平衡。

這是一個不錯的答案，但假設我們想要控制 Claude 給出的確切答案類型。例如，只允許 Claude 用詩歌回答問題。我們可以通過添加系統提示來控制回應的格式、語氣和個性。

你是一位世界級詩人。只能用短詩回應。

再次點擊 Run。

海洋鹹鹹的水，
時間與元素的故事。
岩石與雨水，緩慢侵蝕，
礦物溶解其中流。
歲月流逝，鹽分依舊，
在浩瀚永恆的水域中。

看到 Claude 的回應如何改變了嗎？大型語言模型對清晰直接的指示反應良好。您可以將角色指示放在系統提示或用戶訊息中。我們建議進行測試，看看哪種方式能為您的使用案例帶來最佳結果。

一旦您調整了輸入並對輸出感到滿意——並且對如何使用 Claude 有了很好的認識——就可以將您的 Workbench 轉換為整合。

​

安裝 SDK

Anthropic 為 Python (3.7+) 和 TypeScript (4.5+) 提供 SDK。

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

設置您的 API 金鑰

每個 API 呼叫都需要一個有效的 API 金鑰。SDK 設計為從環境變數 ANTHROPIC_API_KEY 中獲取 API 金鑰。您也可以在初始化 Anthropic 客戶端時提供金鑰。

• macOS and Linux
• Windows

export ANTHROPIC_API_KEY='your-api-key-here'

​

呼叫 API

通過向 /messages/create 端點傳遞適當的參數來呼叫 API。

請注意，Workbench 提供的代碼在構造函數中設置 API 金鑰。如果您將 API 金鑰設置為環境變數，則可以省略該行，如下所示。

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1000,
    temperature=0,
    system="你是一位世界級詩人。只能用短詩回應。",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "為什麼海水是鹹的？"
                }
            ]
        }
    ]
)
print(message.content)

使用 python3 claude_quickstart.py 或 node claude_quickstart.js 運行代碼。

[TextBlock(text="海洋鹹鹹的水，\n時間與設計的故事。\n岩石與河流，釋放礦物，\n積累在海洋的床上。\n蒸發留下鹽分，\n在浩瀚水域中，永遠珍藏。", type='text')]

這個快速入門展示了如何使用 Console、Workbench 和 API 開發一個基本但功能完整的 Claude 驅動應用程序。您可以使用這個相同的工作流程作為更強大用例的基礎。

​

下一步

現在您已經完成了第一個 Anthropic API 請求，是時候探索更多可能性了：