claude-code - 💡(How to fix) Fix Allow customizing the startup greeting text [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#51787Fetched 2026-04-22 07:52:51
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Author
Timeline (top)
labeled ×2commented ×1cross-referenced ×1

Code Example

{
  "greeting": "Welcome to HAAK." 
}

---

greeting: "Welcome to HAAK."
RAW_BUFFERClick to expand / collapse

Feature request

Allow users to customize or replace the startup greeting/banner text that Claude Code displays when a session begins.

Use case

When running Claude Code with custom agent mandates (via --agent or .claude/agents/), the agent's first-turn behavior is fully configurable through CLAUDE.md and SessionStart hooks — but the CLI's own greeting text that appears before the agent speaks is hardcoded. For users building multi-agent systems or domain-specific workflows, the generic greeting creates a disconnect between the tool's identity and the agent's identity.

Proposed solution

A configuration option (in .claude/settings.json, a CLI flag, or a per-agent setting) that lets users specify custom greeting text, or suppress the default greeting entirely so the agent's first response serves as the greeting.

Something like:

{
  "greeting": "Welcome to HAAK." 
}

or per-agent in the agent markdown frontmatter:

greeting: "Welcome to HAAK."

or greeting: false to suppress it.

Related issues

  • #2254 — Disable the welcome banner (suppression only)
  • #50918 — Hide loaded context files banner on startup

This request is specifically about replacement/customization, not just suppression.

extent analysis

TL;DR

To address the feature request, consider adding a configuration option to allow users to customize or replace the startup greeting/banner text in Claude Code.

Guidance

  • Introduce a new configuration option, such as a greeting field in .claude/settings.json, to store the custom greeting text.
  • Update the CLI to read and display the custom greeting text, if set, instead of the hardcoded default.
  • Consider adding a per-agent setting, such as a greeting field in the agent's markdown frontmatter, to allow for agent-specific customizations.
  • Review related issues, such as #2254 and #50918, to ensure consistency in the implementation of greeting customization and suppression.

Example

// .claude/settings.json
{
  "greeting": "Welcome to HAAK."
}

Notes

The proposed solution requires updates to the Claude Code configuration parsing and CLI display logic. The implementation should handle cases where the custom greeting text is not set or is set to an empty string.

Recommendation

Apply a workaround by introducing a custom configuration option, such as the proposed greeting field, to allow users to customize the startup greeting text. This approach addresses the feature request and provides a flexible solution for users with custom agent mandates.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING