Claude 代码重构示例

文件：validators.py

def validate_fields(data: dict, required_fields: list) -> bool:
    """检查所有必需字段是否都存在于 data 中。"""
    return all(field in data for field in required_fields)

文件：main.py

from fastapi import FastAPI, Request
from validators import validate_fields

app = FastAPI()

@app.post("/user")
async def create_user(request: Request):
    """使用可复用的验证处理用户创建。"""
    data = await request.json()
    if not validate_fields(data, ["username", "email"]):
        return {"error": "Invalid user data"}
    return {"message": f"User {data['username']} created successfully"}

@app.post("/product")
async def create_product(request: Request):
    """使用可复用的验证处理产品创建。"""
    data = await request.json()
    if not validate_fields(data, ["name", "price"]):
        return {"error": "Invalid product data"}
    return {"message": f"Product {data['name']} created successfully"}

Claude 代码的系统提示与护栏

在涉及大型或敏感项目的 Claude 代码工作中，控制其行为方式与控制其生成内容同样重要。你不会希望 AI 助手在开发会话过程中即兴发挥或中途改变语气。这正是系统提示和护栏发挥作用的地方。

系统提示充当 Claude 的"个性与行为蓝图"——它定义了模型应如何回应、使用何种语气、遵循哪些规则以及应遵守哪些限制。而护栏则用于建立安全性和一致性的边界，确保 Claude 始终保持在项目的范围、风格和合规要求之内。这些技术共同帮助开发者塑造 Claude 的行为，从而在任何工作流程中获得可预测的高质量结果。

概念阐述

系统提示是 Claude 在一个会话中接收到的第一条指令——这是一种隐藏的配置，用于定义其全局行为。可以将其视为在前言部分设定基调和期望，在读取任何用户提示之前就已生效。Anthropic 的 Claude 模型始终首先在系统消息的上下文中解释提示，使其在决策中享有最高优先级。

这意味着系统提示可以定义 Claude 的推理方式、优先考虑的内容，甚至更倾向于使用何种风格的代码或解释。例如，你可以设置一个系统提示，要求 Claude：

• 编写符合 PEP8 规范的 Python 代码
• 在所有函数中包含文档字符串
• 以简洁的句子解释推理过程

你之后发出的每条指令都将自动继承这种行为模式。

相比之下，护栏是你有意添加的约束，用于防止不期望的行为。它们可以限制 Claude 的范围（例如"只编写与数据库迁移相关的代码"），或强制执行安全规则（例如"绝不暴露真实凭据或不安全的命令"）。护栏在企业环境中至关重要，但它们对于希望从 Claude 获得可预测、可重复输出的个人开发者也同样有价值。

如果应用得当，系统提示和护栏能够让 Claude 在长会话中保持可靠、严谨和一致——就像一个始终遵循你的编码标准和文档实践的初级开发者。

实操示例

让我们通过一个真实场景演示系统提示和护栏是如何工作的。假设你正在使用 Claude 构建一个数据分析助手，它必须生成严格遵循格式和安全准则的 Python 代码。你希望每个响应都包含清晰的注释、可复用的函数和错误处理——同时不暴露敏感的系统操作。

以下是你可以如何定义系统提示并在 Claude 会话中使用它。

系统提示示例

系统提示（开发者设置）："你是 Claude 代码，一个面向数据工程和机器学习的 AI 编程助手。请遵循 PEP8 规范。在每个函数中包含文档字符串。始终为关键操作包含错误处理和日志记录。绝不执行 shell 命令、修改文件或暴露环境变量。在所有解释中保持简洁、专业和清晰。"

一旦设置了该系统提示，后续每个请求都将自动继承这些约束。

现在你发出一个用户提示：

用户提示："编写一个 Python 函数，将 CSV 文件加载到 pandas DataFrame 中，处理缺失值，并打印汇总统计信息。"

在系统提示约束下运行的 Claude 将按照你的护栏做出回应：

import pandas as pd
import logging