如何使用 Claude 構建你的第一個 AI Agent：從首次 API 調用到自動化系統

1while True:
2    user_input = input("> ")
3    response = call_claude(user_input)
4    print(response)

1import anthropic
2
3client = anthropic.Anthropic()
4
5response = client.messages.create(
6    model="claude-sonnet-4-6",
7    max_tokens=4096,
8    system="""你是程式碼審查 Agent。
9
10規則：
11- 在評論之前先閱讀整個 diff
12- 只標記真正的錯誤，而非風格偏好
13- 如果沒有任何問題，請回覆「LGTM」並停止
14- 永遠不要建議你未經心智測試的變更
15- 輸出格式：JSON 陣列，包含 {file, line, issue, fix}""",
16    messages=[{"role": "user", "content": diff_content}]
17)

1# 強制 JSON 輸出，告訴 Claude 確切的形狀
2system = """只回傳有效的 JSON。不要 Markdown。不要解釋。
3結構：
4{
5  "status": "pass" | "fail",
6  "issues": [{"file": str, "line": int, "issue": str}],
7  "summary": str
8}"""

1tools = [{
2    "name": "run_sql",
3    "description": "對資料庫執行唯讀 SQL 查詢",
4    "input_schema": {
5        "type": "object",
6        "properties": {
7            "query": {
8                "type": "string",
9                "description": "要執行的 SQL SELECT 查詢"
10            }
11        },
12        "required": ["query"]
13    }
14},
15{
16    "name": "write_file",
17    "description": "將內容寫入磁碟上的檔案",
18    "input_schema": {
19        "type": "object",
20        "properties": {
21            "path": {"type": "string"},
22            "content": {"type": "string"}
23        },
24        "required": ["path", "content"]
25    }
26}]

1import json
2from pathlib import Path
3
4def run_agent(task: str, max_attempts: int = 5):
5    state = {"task": task, "attempts": [], "done": False}
6
7    for i in range(max_attempts):
8        # 從狀態建立上下文
9        context = build_prompt(state)
10
11        # 使用工具呼叫 Claude
12        result = call_claude(context, tools)
13
14        # 執行任何工具呼叫
15        output = execute_tools(result)
16
17        # 驗證結果
18        check = verify(output)
19
20        # 更新狀態
21        state["attempts"].append({
22            "attempt": i + 1,
23            "action": result.summary,
24            "passed": check.passed,
25            "reason": check.reason
26        })
27
28        if check.passed:
29            state["done"] = True
30            break
31
32    # 儲存狀態以供下次執行
33    Path("state.json").write_text(json.dumps(state, indent=2))
34    return state

1# CLAUDE.md
2
3## 專案
4任務管理 API。Python 3.12、FastAPI、PostgreSQL。
5
6## 規則
7- 所有回應：{data, error, meta} 結構
8- 每個新端點都需要測試
9- 提交訊息：type(scope): description
10- 永遠不要使用 print() 記錄日誌。使用 structlog。
11
12## 已知問題
13- 認證中介軟體預期 x-auth-token，而非 Authorization
14- 測試套件完整執行需 45 秒。使用 --filter 進行迭代。

1# learnings.md
2
3- 付款 API 預期冪等性金鑰在標頭中，而非主體
4- PostgreSQL NOTIFY 需要在連線池中明確 LISTEN
5- 速率限制器按金鑰計數，而非 IP。測試需要唯一金鑰。

1def verify(output):
2    # 執行測試套件
3    result = subprocess.run(
4        ["pytest", "tests/", "-x", "--tb=short"],
5        capture_output=True, text=True
6    )
7    return {
8        "passed": result.returncode == 0,
9        "reason": result.stdout if result.returncode != 0 else "all tests pass"
10    }

1# 審查者提示——與建構者分開
2reviewer_system = """你是嚴格的程式碼審查者。
3你唯一的工作是找出問題。
4
5檢查：
6- 程式碼是否符合規格？
7- 是否有未捕捉到的邊界情況？
8- 所有測試是否真的測試了正確的東西？
9
10如果一切正確，回覆：{"passed": true}
11如果有任何錯誤，回覆：{"passed": false, "issues": [...]}
12
13不要建議改進。只標記真正的錯誤。"""

1import anthropic, subprocess, json
2from pathlib import Path
3
4client = anthropic.Anthropic()
5CLAUDE_MD = Path("CLAUDE.md").read_text()
6LEARNINGS = Path("learnings.md").read_text()
7
8SYSTEM = f"""你是程式碼 Agent。
9閱讀 Issue。撰寫修正。執行測試。
10
11專案上下文：
12{CLAUDE_MD}
13
14已知問題：
15{LEARNINGS}
16
17規則：
18- 在變更任何內容之前先閱讀完整程式碼庫
19- 為每個變更撰寫測試
20- 如果測試失敗，修正程式碼，而非測試
21- 當所有測試通過時停止"""
22
23TOOLS = [
24    read_file_tool,
25    write_file_tool,
26    run_command_tool,
27    search_codebase_tool,
28]
29
30def run(issue_text, max_attempts=5):
31    messages = [{"role": "user", "content": issue_text}]
32
33    for attempt in range(max_attempts):
34        # 呼叫 Claude
35        response = client.messages.create(
36            model="claude-sonnet-4-6",
37            max_tokens=8192,
38            system=SYSTEM,
39            tools=TOOLS,
40            messages=messages
41        )
42
43        # 執行工具呼叫
44        messages = handle_tool_use(response, messages)
45
46        # 驗證：執行測試
47        test_result = subprocess.run(
48            ["pytest", "-x", "--tb=short"],
49            capture_output=True, text=True
50        )
51
52        if test_result.returncode == 0:
53            print(f"在 {attempt + 1} 次嘗試後完成")
54            return True
55
56        # 將失敗資訊回饋到迴圈中
57        messages.append({
58            "role": "user",
59            "content": f"測試失敗：\n{test_result.stdout}\n請修正並重試。"
60        })
61
62    return False