快速入門
讓我們學習如何使用 Anthropic API 來建構 Claude。
在這個例子中，我們將讓 Claude 編寫一個 Python 函數來檢查字串是否為回文。
先決條件
要完成這個快速入門，你需要：
- 一個 Anthropic Console 帳戶
- 一個 API 金鑰
- Python 3.7+ 或 TypeScript 4.5+
Anthropic 提供 Python 和 TypeScript SDK，但你也可以直接向 API 發送 HTTP 請求。
從 Workbench 開始
無論你進行什麼特定任務，任何 API 調用都會向 Anthropic API 發送一個配置良好的提示。在學習如何充分利用 Claude 時，我們建議你從 Workbench 開始開發過程，Workbench 是一個基於網頁的 Claude 界面。
登入 Anthropic Console 並點擊 Workbench。
在中間部分的 User 下，讓我們向 Claude 提出一個問題。
為什麼海洋是鹹的？
點擊 Run。在右側，你會看到類似這樣的輸出：
海洋之所以鹹，是由於幾個因素：
1. 岩石風化：數百萬年來，雨水、河流和溪流侵蝕了含有礦物鹽的岩石。這些鹽分通過水流被帶入海洋。
2. 火山活動：海底火山和熱液噴口將礦物質（包括鹽分）釋放到海水中。
3. 大氣沉積：海洋噴霧中的鹽粒子可以被風帶走並重新沉積到海洋中。
4. 蒸發：當水從海洋表面蒸發時，它會留下溶解的鹽分，增加剩餘水中的鹽分濃度。
5. 生物過程：一些海洋生物通過釋放鹽化合物作為其代謝的副產品，也為海洋的鹽度做出貢獻。
隨著時間的推移，這些過程不斷地向海洋添加鹽分，而蒸發則去除純水，導致海洋目前的鹽度水平。重要的是要注意，海洋中的總鹽量保持相對穩定，因為鹽分的輸入與通過蒸發沉積物形成等過程的鹽分移除達到平衡。
這是一個不錯的答案，但假設我們想控制 Claude 給出的確切答案類型。例如，只允許 Claude 用詩歌回答問題。我們可以通過添加系統提示來控制回應的格式、語氣和個性。
你是一位世界級的詩人。只能用短詩回應。
再次點擊 Run。
海洋鹹鹹的鹽水，
時間與元素結合的故事。
岩石與雨水，緩慢侵蝕，
礦物溶解在溶液中。
歲月流逝，鹽分依舊，
在廣闊永恆的水域中。
看到 Claude 的回應如何改變了嗎？LLM 對清晰直接的指示反應良好。你可以將角色指示放在系統提示或用戶消息中。我們建議進行測試，看看哪種方式能為你的用例產生最佳結果。
一旦你調整了輸入，對輸出感到滿意，並對如何使用 Claude 有了很好的理解，就將你的 Workbench 轉換為集成。
安裝 SDK
Anthropic 為 Python (3.7+) 和 TypeScript (4.5+) 提供 SDK。
在你的項目目錄中，創建一個虛擬環境。
python -m venv claude-env
使用以下命令激活虛擬環境
- 在 macOS 或 Linux 上，
source claude-env/bin/activate - 在 Windows 上，
claude-env\Scripts\activate
pip install anthropic
設置你的 API 金鑰
每個 API 調用都需要一個有效的 API 金鑰。SDK 設計為從環境變量 ANTHROPIC_API_KEY 中提取 API 金鑰。你也可以在初始化 Anthropic 客戶端時提供金鑰。
export ANTHROPIC_API_KEY='你的-api-金鑰-在這裡'
調用 API
通過向 /messages/create 端點傳遞適當的參數來調用 API。
請注意，Workbench 提供的代碼在構造函數中設置 API 金鑰。如果你將 API 金鑰設置為環境變量，可以省略下面的那行代碼。
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-3-5-sonnet-20240620",
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 請求，是時候探索更多可能性了：