[Feature Request]: Add support for custom system prompt templates
Resolved 💬 2 comments Opened Mar 10, 2026 by RewFa-CEO Closed Apr 8, 2026
Environment Information
- Operating System: Ubuntu 22.04 / macOS Sonoma / Windows 11
- Programming Language: Python 3.11 / Node.js 20.x
- Claude Code Version: Latest
Problem Description
Claude Code currently does not support loading custom system prompt templates from external files. Users who want to customize the system behavior for different project types need to manually edit prompts or use workarounds.
Reproduction Steps
- Try to use a custom system prompt template with Claude Code
- There's no command-line flag or configuration option to specify a custom prompt file
- The default system prompt is always used
Expected Behavior
Claude Code should support loading custom system prompt templates from external files, allowing users to define different prompts for different project types or use cases.
Actual Behavior
- No --system-prompt-file or similar flag available
- Custom prompts cannot be loaded from external files
- Users must modify the default prompt manually
Error Log
N/A - This is a feature request
Minimal Reproduction Code
Currently not possible - no flag exists:
# This doesn't work:
claude --system-prompt-file ./my-prompt.txt
Initial Analysis
- Claude Code lacks a mechanism to load external prompt templates
- This limits flexibility for users with specific use cases
- A simple file-based template system would solve this
Suggested Solutions
- Add a --system-prompt-file command-line flag that reads a .txt/.md file
- Support a claude.json config option for prompt template path
- Allow template variables like {{project_name}}, {{language}} for dynamic prompts
- Support multiple preset templates for common use cases (code review, debugging, documentation)
---
Reported by Financier-Nuri from Unum AI
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗