--append-system-prompt 参数

概述

--append-system-prompt 标志允许您将自定义内容附加到 Claude 的默认系统提示之后，而不是完全替换它。这种方式可以保留 Claude 的核心行为和能力，同时添加您特定的指导或约束。

标志语法

claude --append-system-prompt "附加的提示内容"

与 --system-prompt 的区别

标志	行为	使用场景
`--system-prompt`	完全替换默认系统提示	需要完全自定义 Claude 的行为
`--append-system-prompt`	附加到默认系统提示	需要在保留核心能力的基础上添加特定指导

使用场景

添加项目特定规则

保留 Claude 的核心能力，同时添加项目特定的约束：

claude --append-system-prompt "在这个项目中，所有 API 端点必须包含认证中间件，数据库操作必须使用事务，敏感数据必须加密存储。"

指定输出格式

要求 Claude 以特定格式输出，而不影响其核心推理能力：

claude --append-system-prompt "所有代码示例必须包含类型注解和文档字符串。输出格式必须使用 Markdown 代码块。"

添加领域特定知识

在 Claude 的通用知识基础上，添加特定领域的指导：

claude --append-system-prompt "你正在为医疗设备软件工作。所有代码必须遵循 IEC 62304 标准，并包含详细的单元测试。"

设置语言偏好

指定回答的语言或术语偏好：

claude --append-system-prompt "请使用简体中文回答所有问题。技术术语保留英文原文。"

添加安全约束

在保留 Claude 安全能力的基础上，添加额外的安全要求：

claude --append-system-prompt "对于任何涉及用户数据的操作，必须先进行数据脱敏处理。所有密码必须使用 bcrypt 哈希。"

高级用法

多行提示

使用引号包裹多行提示：

claude --append-system-prompt "
在这个项目中：
- 使用 TypeScript 严格模式
- 所有函数必须有类型注解
- 所有类必须有文档字符串
"

与其他标志组合

# 附加系统提示并设置模型
claude --append-system-prompt "使用 TypeScript 严格模式" --model opus

# 附加系统提示并限制工具
claude --append-system-prompt "只使用 Read 和 Grep 工具" --allowedTools "Read" "Grep"

# 附加系统提示并指定输出格式
claude --append-system-prompt "输出 JSON 格式" --output-format json

管道输入配合使用

# 附加系统提示并处理管道输入
cat code.py | claude --append-system-prompt "使用 PEP 8 风格指南" -p "审查这段代码"

# 附加系统提示并使用 SDK 查询
claude --append-system-prompt "关注性能优化" -p "优化这个函数"

环境变量

# 设置环境变量
export APPEND_PROMPT="使用公司内部代码规范"

# 使用环境变量
claude --append-system-prompt "$APPEND_PROMPT"

实际应用示例

示例 1: Web 开发项目

claude --append-system-prompt "
项目技术栈：React 18, TypeScript, Tailwind CSS
代码规范：
- 使用函数组件和 Hooks
- 所有组件必须有 PropTypes 或 TypeScript 类型
- 样式使用 Tailwind CSS 类名
- 状态管理使用 Redux Toolkit
"

示例 2: 数据科学项目

claude --append-system-prompt "
数据科学项目规范：
- 使用 Python 3.9+
- 数据处理使用 Pandas
- 可视化使用 Matplotlib 和 Seaborn
- 机器学习使用 scikit-learn
- 所有代码必须有类型注解
- Jupyter Notebook 必须转换为 Python 脚本
"

示例 3: DevOps 项目

claude --append-system-prompt "
DevOps 项目要求：
- 所有基础设施即代码使用 Terraform
- CI/CD 使用 GitHub Actions
- 容器化使用 Docker
- 编排使用 Kubernetes
- 监控使用 Prometheus 和 Grafana
- 日志使用 ELK Stack
"

示例 4: 移动应用开发

claude --append-system-prompt "
移动应用开发规范：
- 使用 React Native
- 状态管理使用 MobX
- 导航使用 React Navigation
- 网络请求使用 Axios
- 本地存储使用 AsyncStorage
- 所有组件必须有 TypeScript 类型
"

最佳实践

明确且简洁

保持附加提示明确且简洁：

# 好的示例
claude --append-system-prompt "所有函数必须有类型注解和文档字符串"

# 不好的示例
claude --append-system-prompt "请确保你编写的所有代码都包含适当的类型注解，并且每个函数都应该有详细的文档字符串来解释它的功能、参数和返回值"

使用编号列表

对于多个要求，使用编号列表：

claude --append-system-prompt "代码规范：\n1. 所有函数必须有类型注解\n2. 所有函数必须有文档字符串\n3. 所有类必须有文档字符串"

提供示例

在提示中包含示例：

claude --append-system-prompt "
函数格式示例：
def calculate_total(items: List[Item]) -> float:
    \"\"\"计算商品总价\"\"\"
    return sum(item.price for item in items)
"

分离关注点

将不同类型的关注点分开：

# 代码风格
claude --append-system-prompt "使用 PEP 8 风格指南"

# 安全要求
claude --append-system-prompt "所有用户输入必须验证和清理"

# 性能要求
claude --append-system-prompt "优先考虑时间复杂度 O(n) 的算法"

常见问题

问题	答案
附加提示的长度有限制吗？	有一定的限制，但通常足够长。如果提示非常长，建议使用 `--system-prompt-file` 从文件加载。
可以多次使用 --append-system-prompt 吗？	不可以。每次只能使用一次。如果需要添加多个内容，请将它们合并为一个提示。
附加提示会影响 Claude 的核心能力吗？	不会。`--append-system-prompt` 只是在默认系统提示后添加内容，不会替换核心能力。
何时使用 --append-system-prompt 而不是 --system-prompt？	当您希望保留 Claude 的核心行为和能力，只需要添加特定指导时使用 `--append-system-prompt`。当您需要完全自定义 Claude 的行为时使用 `--system-prompt`。
附加提示的优先级如何？	附加提示会与默认系统提示一起工作。如果存在冲突，附加提示通常具有更高的优先级。

与其他标志的组合示例

完整的开发环境设置

claude \
  --append-system-prompt "使用 TypeScript 严格模式，编写单元测试" \
  --model opus \
  --allowedTools "Read" "Write" "Grep" "RunCommand" \
  --verbose

代码审查会话

claude \
  --append-system-prompt "代码审查重点：安全性、性能、可维护性" \
  --model opus \
  --output-format json \
  -p "审查 src/auth.py"

文档生成

claude \
  --append-system-prompt "生成符合 Google 风格的 API 文档" \
  --model opus \
  --output-format markdown \
  -p "为所有 API 端点生成文档"

测试生成

claude \
  --append-system-prompt "使用 pytest 编写单元测试，覆盖率至少 80%" \
  --model opus \
  --allowedTools "Read" "Write" \
  -p "为 src/utils.py 生成测试"

--append-system-prompt 参数

On this page