系统提示词

系统提示词是在每次请求中先于对话发送给模型的指令,规定模型的角色与须遵循的行为规则。

在 Claude API 中,它是独立于消息列表的 system 参数。编码代理的系统提示词通常由代理开发者编写,涵盖行为方式、工具使用和回答格式,在用户输入前便已存在。Claude Code 可用 --system-prompt 替换它,或用 --append-system-prompt 扩充它。

它周围还有其他指令层。定义了工具时,Anthropic API 会加入工具使用的系统提示词;启用思考时也会加入相应提示词。每个请求会包含客户端开放给模型的工具定义。CLAUDE.md 不属于系统提示词,Claude Code 会在系统提示词之后把该文件作为用户消息载入。

系统提示词通常在请求之间保持不变,因此适合提示缓存:首轮之后,命中的前缀可以用较低价格读取。修改它的成本也因此较高。Anthropic 按工具、系统提示词、消息的顺序缓存;系统提示词一旦改变,其后的已缓存内容失效,下次请求需要重新处理。

只针对当前任务的指令更适合放在对话中。Claude Code 的计划模式和技能会把相应指令追加为对话消息,从而保留前面稳定的缓存前缀。

← 全部术语