Mac 上 Claude API 开发入门指南：从环境配置到第一个代码示例

1次阅读

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

在开始之前，我们需要确保 Mac 上有一个可用的 Python 开发环境。推荐使用 Python 3.8 或更高版本，因为这些版本对 Claude API 的支持更好。

检查 Python 版本：
打开终端，输入以下命令检查 Python 版本：
```
python3 --version
```
如果未安装 Python，可以从 Python 官网下载并安装。
安装必要的库：
Claude API 的开发通常需要 requests 库来处理 HTTP 请求。安装命令如下：
```
pip3 install requests
```
虚拟环境（可选但推荐）：
使用虚拟环境可以隔离项目依赖，避免全局安装的冲突。创建和激活虚拟环境的命令如下：
```
python3 -m venv claude_env
source claude_env/bin/activate
```

获取 API 密钥：
登录 Claude 开发者平台，在控制台中生成 API 密钥。确保妥善保管密钥，不要直接硬编码在代码中。
安全存储密钥：
推荐使用环境变量存储 API 密钥。在终端中运行以下命令：
```
export CLAUDE_API_KEY='your_api_key_here'
```
然后在 Python 代码中通过 os.environ 获取：
```
import os
api_key = os.environ.get('CLAUDE_API_KEY')
```

以下是一个简单的 Python 脚本，演示如何调用 Claude API 并处理响应：

import requests
import os

# 从环境变量获取 API 密钥
api_key = os.environ.get('CLAUDE_API_KEY')
if not api_key:
    raise ValueError("API key not found in environment variables")

# API 端点
url = "https://api.claude.ai/v1/complete"

# 请求头
headers = {"Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# 请求体
payload = {
    "prompt": "Hello, Claude!",
    "max_tokens": 50
}

# 发送请求
try:
    response = requests.post(url, headers=headers, json=payload)
    response.raise_for_status()  # 检查 HTTP 错误
    print(response.json())
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

SSL 证书问题：
Mac 有时会遇到 SSL 证书验证失败的问题。可以尝试以下解决方案：
更新系统的根证书：/Applications/Python\ 3.x/Install\ Certificates.command

临时禁用 SSL 验证（不推荐用于生产环境）：

requests.post(url, headers=headers, json=payload, verify=False)

网络连接问题：
确保你的网络连接正常，尤其是如果你在使用代理。可以通过以下命令测试：
```
curl -v https://api.claude.ai
```

批量请求：
如果可能，尽量将多个请求合并为一个批量请求，减少 API 调用次数。
缓存响应：
对于不经常变化的数据，可以考虑缓存 API 响应，避免重复请求。

密钥管理：
永远不要在代码或版本控制系统中硬编码 API 密钥。使用环境变量或密钥管理服务。
请求验证：
确保所有 API 请求都经过身份验证，并且只从可信的来源接收数据。

以下是一个简单的命令行工具，允许用户与 Claude 进行交互：

import requests
import os
import readline  # 用于命令行历史记录

# 配置
API_KEY = os.environ.get('CLAUDE_API_KEY')
API_URL = "https://api.claude.ai/v1/complete"

if not API_KEY:
    print("Error: API key not found. Please set CLAUDE_API_KEY environment variable.")
    exit(1)

# 发送请求到 Claude API
def ask_claude(prompt):
    headers = {"Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "prompt": prompt,
        "max_tokens": 150
    }
    try:
        response = requests.post(API_URL, headers=headers, json=payload)
        response.raise_for_status()
        return response.json().get('choices', [{}])[0].get('text', "No response")
    except Exception as e:
        return f"Error: {str(e)}"

# 主循环
def main():
    print("Claude CLI - Type'quit'to exit")
    while True:
        try:
            user_input = input("You:")
            if user_input.lower() in ['quit', 'exit']:
                break
            response = ask_claude(user_input)
            print(f"Claude: {response}")
        except KeyboardInterrupt:
            break

if __name__ == "__main__":
    main()