Claude Code 在 Mac 上的新手入门指南：从安装到第一个 AI 助手

1次阅读

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

在 Mac 上开发 Claude Code 应用，首先需要确保 Python 环境正确配置。推荐使用 Homebrew 管理工具来安装 Python，并创建独立的虚拟环境以避免依赖冲突。

安装 Homebrew（如果尚未安装）：

# bash/zsh 通用命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

通过 Homebrew 安装 Python 3.9+：

brew install python@3.9

mkdir claude_project && cd claude_project
python3.9 -m venv venv
source venv/bin/activate  # 激活虚拟环境

访问 Claude AI 官方网站注册账号后：

登录到控制台
导航至 API Keys 部分
点击 “Create New API Key”
复制生成的密钥（务必妥善保存）

安装必要的 Python 库：

pip install requests python-dotenv

创建 .env 文件存储 API 密钥：

CLAUDE_API_KEY=your_api_key_here

基础对话示例代码 (claude_chat.py)：

import os
import requests
from dotenv import load_dotenv

# 加载环境变量
load_dotenv()

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

headers = {"Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def chat_with_claude(prompt):
    """
    与 Claude 进行基础对话
    :param prompt: 用户输入的提示词
    :return: Claude 的回复
    """data = {"prompt": prompt,"model":"claude-v1",  # 指定模型版本"max_tokens": 100,     # 限制响应长度"temperature": 0.7,    # 控制创造性（0-1）"stop_sequences": ["\nHuman:"]  # 停止标记
    }

    try:
        response = requests.post(
            API_URL,
            headers=headers,
            json=data,
            timeout=30  # 设置超时
        )
        response.raise_for_status()  # 检查 HTTP 错误
        return response.json()["completion"]
    except requests.exceptions.RequestException as e:
        print(f"请求错误: {e}")
        return None

if __name__ == "__main__":
    user_input = input("你想问 Claude 什么？\n")
    response = chat_with_claude(user_input)
    print(f"\nClaude 回复:\n{response}")

参数说明：

max_tokens: 控制响应长度，值越大响应越长
temperature: 控制响应创造性（0- 更确定性，1- 更随机性）
stop_sequences: 指定停止生成的标记

如果遇到 SSL 证书验证问题，可以临时禁用验证（不推荐生产环境使用）：

response = requests.post(API_URL, headers=headers, json=data, verify=False)

或者更新证书：

# 更新证书（Mac）brew install certifi

国内用户可能需要设置代理：

proxies = {
    "http": "http://your_proxy:port",
    "https": "http://your_proxy:port"
}
response = requests.post(API_URL, headers=headers, json=data, proxies=proxies)

永远不要 将 API 密钥硬编码在代码中
将 .env 添加到 .gitignore
限制 API 调用频率（Claude 有速率限制）
考虑使用密钥管理服务如 AWS Secrets Manager

安装 Gradio：

pip install gradio

简单界面代码示例：

import gradio as gr

def claude_interface(prompt):
    return chat_with_claude(prompt)

iface = gr.Interface(
    fn=claude_interface,
    inputs="text",
    outputs="text",
    title="Claude 聊天助手"
)
iface.launch()

直接在终端测试 API：

curl -X POST https://api.claude.ai/v1/complete \
  -H "Authorization: Bearer $CLAUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Hello Claude","model":"claude-v1","max_tokens": 50}'

通过这篇指南，你应该已经掌握了在 Mac 上搭建 Claude AI 助手的基础流程。从环境配置到 API 调用，再到安全实践和界面构建，这些知识为你进一步探索 Claude 的强大功能打下了坚实基础。在实际开发中，记得多查阅官方文档，并根据自己的需求调整参数配置。

正文完