Mac 上 Claude 技能开发入门指南：从零搭建你的第一个 AI 助手

1次阅读

共计 1922 个字符，预计需要花费 5 分钟才能阅读完成。

Claude 是 Anthropic 推出的 AI 助手 API，具有以下核心特点：

对话式交互：支持多轮对话上下文保持
结构化输出：可返回 JSON 等格式数据
高可控性：通过系统提示词精确控制输出风格

适用场景包括智能客服、个人助手、内容生成等需要自然语言处理的场景。

Python 环境：
推荐 Python 3.8+
使用 Homebrew 安装：brew install python@3.9
依赖安装：
```
pip install anthropic python-dotenv
```
API Key 准备：
在 Anthropic 控制台创建 API Key
在项目根目录创建 .env 文件：
```
ANTHROPIC_API_KEY=your_key_here
```

import anthropic
import os
from dotenv import load_dotenv

load_dotenv()

client = anthropic.Client(api_key=os.getenv("ANTHROPIC_API_KEY")
)

def get_weather_response(location):
    response = client.messages.create(
        model="claude-3-opus-20240229",
        max_tokens=1024,
        system="你是一个天气助手，只回答天气相关问题",
        messages=[{"role": "user", "content": f"{location}的天气如何？"}
        ]
    )
    return response.content[0].text

import time
from anthropic import RateLimitError

def safe_get_weather(location, retries=3):
    for attempt in range(retries):
        try:
            return get_weather_response(location)
        except RateLimitError:
            if attempt == retries - 1:
                raise
            time.sleep(2 ** attempt)

免费版：5 RPM（每分钟请求数）
付费版：可申请提升限额
建议实现请求队列或指数退避重试

永远不要硬编码 API Key
使用环境变量或密钥管理服务
设置最小必要权限

缓存常用响应
使用流式响应减少延迟
批量处理多个请求

# weather_bot.py
import anthropic
import os
import time
from dotenv import load_dotenv
from anthropic import RateLimitError

load_dotenv()

class WeatherBot:
    def __init__(self):
        self.client = anthropic.Client(api_key=os.getenv("ANTHROPIC_API_KEY")
        )

    def get_weather(self, location, retries=3):
        """获取指定地点的天气信息"""
        for attempt in range(retries):
            try:
                response = self.client.messages.create(
                    model="claude-3-opus-20240229",
                    max_tokens=1024,
                    system="你是一个专业的天气助手",
                    messages=[{"role": "user", "content": f"请告诉我 {location} 的天气情况"}
                    ]
                )
                return response.content[0].text
            except RateLimitError:
                if attempt == retries - 1:
                    raise
                time.sleep(2 ** attempt)

if __name__ == "__main__":
    bot = WeatherBot()
    print(bot.get_weather("北京"))