6.7 --system-prompt-file - 从文件加载系统提示
约 1908 字大约 6 分钟
概述
--system-prompt-file 标志允许您从文件中加载自定义的系统提示，而不是直接在命令行中输入。这对于复杂的系统提示、需要版本控制的提示，或者需要在不同项目间共享的提示特别有用。
基本语法
claude --system-prompt-file <文件路径>使用场景
1. 复杂系统提示
当您的系统提示非常长或包含多个部分时，使用文件可以更好地组织内容：
# 创建系统提示文件
cat > python-expert.txt << 'EOF'
你是一位资深的 Python 开发专家，具有以下专长：
- Python 3.8+ 的所有新特性
- 异步编程和并发
- 数据科学和机器学习
- Web 开发（Django, Flask, FastAPI）
- 性能优化和调试
在回答问题时，请：
EOF
# 使用文件加载系统提示
claude --system-prompt-file python-expert.txt2. 项目特定的系统提示
为不同的项目创建专门的系统提示文件：
# 项目 A 的系统提示
cat > project-a-prompt.txt << 'EOF'
你正在为 Project A 工作，这是一个金融科技应用。
技术栈：Python 3.9, Django 4.0, PostgreSQL, Redis
关键规则：
- 所有金融计算必须使用 decimal.Decimal
- 敏感数据必须加密存储
- 所有 API 端点需要认证
- 日志记录必须包含审计信息
EOF
# 项目 B 的系统提示
cat > project-b-prompt.txt << 'EOF'
你正在为 Project B 工作，这是一个电商平台。
技术栈：Node.js 18, Express, MongoDB, Elasticsearch
关键规则：
- 使用 TypeScript 进行类型安全
- 所有数据库操作使用事务
- 实现缓存策略
- 监控和追踪所有用户行为
EOF
# 根据项目使用不同的系统提示
cd project-a
claude --system-prompt-file project-a-prompt.txt
cd project-b
claude --system-prompt-file project-b-prompt.txt3. 版本控制系统提示
将系统提示文件纳入版本控制，便于团队协作和历史追溯：
# 项目结构
my-project/
├── prompts/
│ ├── system-prompt-v1.txt
│ ├── system-prompt-v2.txt
│ └── system-prompt.txt -> system-prompt-v2.txt
└── src/
# 使用当前版本的系统提示
claude --system-prompt-file prompts/system-prompt.txt4. 多语言系统提示
为不同语言创建专门的系统提示文件：
# Python 专家提示
cat > python-expert.txt << 'EOF'
你是一位 Python 专家，精通：
- Python 3.8+ 的所有特性
- 常用框架：Django, Flask, FastAPI
- 数据科学：NumPy, Pandas, Matplotlib
- 机器学习：scikit-learn, TensorFlow, PyTorch
EOF
# JavaScript 专家提示
cat > javascript-expert.txt << 'EOF'
你是一位 JavaScript 专家，精通：
- ES6+ 的所有特性
- 前端框架：React, Vue, Angular
- 后端：Node.js, Express, NestJS
- 工具链：Webpack, Vite, ESLint
EOF
# 根据需要选择
claude --system-prompt-file python-expert.txt
claude --system-prompt-file javascript-expert.txt高级用法
1. 与其他标志组合使用
# 使用文件加载系统提示，并设置模型
claude --system-prompt-file security-reviewer.txt --model opus
# 使用文件加载系统提示，并限制工具
claude --system-prompt-file code-analyzer.txt --allowedTools "Read" "Grep"
# 使用文件加载系统提示，并指定输出格式
claude --system-prompt-file api-docs.txt --output-format json2. 管道输入配合使用
# 从文件加载系统提示，并处理管道输入
cat code.py | claude --system-prompt-file code-reviewer.txt -p "审查这段代码"
# 从文件加载系统提示，并使用 SDK 查询
claude --system-prompt-file data-scientist.txt -p "分析这个数据集"3. 环境变量指定文件路径
# 设置环境变量
export SYSTEM_PROMPT_FILE=~/.claude/prompts/default-prompt.txt
# 使用环境变量
claude --system-prompt-file "$SYSTEM_PROMPT_FILE"4. 动态生成系统提示文件
# 根据当前目录动态生成系统提示
cat > dynamic-prompt.txt << EOF
你正在 $(basename $(pwd)) 项目中工作。
项目信息：
$(cat README.md 2>/dev/null | head -20)
技术栈：
$(cat package.json 2>/dev/null | grep -A 20 "dependencies" || cat requirements.txt 2>/dev/null || echo "未检测到依赖文件")
EOF
# 使用动态生成的系统提示
claude --system-prompt-file dynamic-prompt.txt文件格式建议
1. 结构化提示
# 角色定义
你是一位 [角色名称]
# 专业领域
- 领域 1
- 领域 2
- 领域 3
# 工作原则
# 输出要求
- 要求 1
- 要求 2
- 要求 3
# 禁止事项
- 禁止 1
- 禁止 2
### 2. 包含示例的提示
你是一位代码审查专家。
审查标准：
输出格式：
## 审查结果
### 优点
- 优点 1
- 优点 2
### 问题
- 问题 1
- 问题 2
### 建议
- 建议 1
- 建议 2
示例：
[提供 1-2 个具体的审查示例]最佳实践
1. 文件组织
推荐的目录结构
~/.claude/
├── prompts/
│ ├── general/
│ │ ├── code-assistant.txt
│ │ ├── code-reviewer.txt
│ │ └── debugger.txt
│ ├── languages/
│ │ ├── python-expert.txt
│ │ ├── javascript-expert.txt
│ │ └── go-expert.txt
│ └── domains/
│ ├── web-dev.txt
│ ├── data-science.txt
│ └── devops.txt2. 文件命名约定
- 使用描述性名称：python-expert.txt 而不是 prompt1.txt
- 包含版本信息：code-reviewer-v2.txt
- 使用小写和连字符：security-auditor.txt 而不是 SecurityAuditor.txt
3. 文档化提示
在每个提示文件的开头添加注释：
# 系统提示：Python 专家
# 版本：1.2
# 创建日期：2024-01-15
# 最后更新：2024-02-20
# 作者：团队 A
# 用途：为 Python 开发提供专家级建议
你是一位资深的 Python 开发专家...4. 版本控制
# 使用 Git 管理提示文件
cd ~/.claude/prompts
git init
git add .
git commit -m "Initial prompt collection"
# 创建分支进行实验
git checkout -b experiment-new-prompt
# 修改提示文件
git add .
git commit -m "Try new prompt structure"常见问题
Q1: 系统提示文件支持哪些格式？
A: 支持纯文本格式（.txt, .md）。建议使用 .txt 或 .md 格式，便于编辑和版本控制。
Q2: 文件路径可以是相对路径吗？
A: 可以。支持相对路径和绝对路径。相对路径是相对于当前工作目录。
Q3: 文件不存在会发生什么？
A: Claude 会报错并提示文件不存在。请确保文件路径正确。
Q4: 可以使用环境变量吗？
A: 可以。在命令行中使用环境变量：claude --system-prompt-file "$MY_PROMPT_FILE"
Q5: 与 --system-prompt 有什么区别？
A: --system-prompt 直接在命令行中指定提示，适合简单的提示；--system-prompt-file 从文件加载，适合复杂、需要版本控制或共享的提示。
示例：完整的提示文件
# 系统提示：全栈开发专家
# 版本：2.0
# 最后更新：2024-02-20
你是一位全栈开发专家，具有以下专长：
## 前端开发
- React, Vue, Angular
- TypeScript, JavaScript
- CSS, Sass, Tailwind CSS
- Webpack, Vite
- 测试：Jest, Cypress
## 后端开发
- Node.js, Python, Go
- RESTful API, GraphQL
- 数据库：PostgreSQL, MongoDB, Redis
- 认证与授权
- 微服务架构
## DevOps
- Docker, Kubernetes
- CI/CD：GitHub Actions, GitLab CI
- 云平台：AWS, GCP, Azure
- 监控：Prometheus, Grafana
## 工作原则
1. **代码质量优先**
- 遵循 SOLID 原则
- 编写可测试的代码
- 注重性能和安全性
2. **最佳实践**
- 使用设计模式
- 编写清晰的文档
- 实施代码审查
3. **团队协作**
- 遵循项目规范
- 提供详细的代码注释
- 分享知识和经验
## 输出要求
- 提供完整的代码示例
- 解释关键概念和原理
- 指出潜在的问题和风险
- 建议相关的工具和资源
- 考虑可维护性和可扩展性
## 禁止事项
- 不要提供不安全的代码
- 不要忽略性能问题
- 不要跳过错误处理
- 不要使用过时的技术总结
--system-prompt-file 标志提供了一种灵活、可维护的方式来管理复杂的系统提示。通过使用文件，您可以：
- 更好地组织和版本控制提示
- 在不同项目和团队间共享提示
- 创建特定领域的专家提示
- 动态生成和调整提示
建议为常用的场景创建专门的提示文件，并将其纳入版本控制系统，以提高工作效率和团队协作效果。