Configured Company Announcements

Display custom organization announcements and reminders within Claude Code sessions.

When to Use This Setting

Apply this setting when you need to:

• Broadcast important company guidelines, policy updates, or tool announcements to all Claude Code users
• Provide contextual reminders about internal resources, coding standards, or upcoming deadlines
• Create a communication channel that reaches developers directly in their development environment Consider alternatives when:
• Your announcements change frequently and managing them through settings files creates overhead
• You have fewer than five team members and direct communication channels are more efficient

Quick Start

Configuration

Copy
name: configured-company-announcements
type: setting
category: global

Example Application

Copy
claude setting:apply configured-company-announcements

Example Output

Setting applied. Changes:
- companyAnnouncements: 3 announcements configured
- Announcements rotate on each session start

Core Concepts

Announcement System Overview

Aspect	Details
Display Location	Announcements appear at the start of each Claude Code session
Rotation	Multiple announcements cycle through on subsequent session starts
Content Type	Plain text strings supporting basic information and URLs
Management	Announcements are stored in the settings JSON and updated via settings apply

Announcement Distribution Architecture

+---------------------------+
|  Admin / Team Lead        |
|  Updates settings file    |
+------------+--------------+
             |
             v
+---------------------------+
| companyAnnouncements:     |
| [                         |
|   "Message 1...",         |
|   "Message 2...",         |
|   "Message 3..."          |
| ]                         |
+------------+--------------+
             |
     +-------+-------+
     |       |       |
     v       v       v
  Dev A   Dev B   Dev C
  sees    sees    sees
  msg 1   msg 2   msg 3

Configuration

Parameter	Type	Default	Description
companyAnnouncements	array	[]	Array of announcement strings to display to users
companyAnnouncements[0]	string	N/A	First announcement message, can include URLs and instructions
companyAnnouncements[1]	string	N/A	Second announcement message for rotation
companyAnnouncements[2]	string	N/A	Third announcement message for rotation
description	string	N/A	Explanation of the announcement system purpose

Best Practices

1. Keep announcements concise and actionable - Each announcement should communicate one idea clearly. Include a URL or command when the announcement points to a resource so developers can act immediately.
2. Rotate announcements with priority ordering - Place the most important announcement first in the array. If developers only see the first message, ensure it contains the highest-priority information.
3. Update announcements on a regular cadence - Stale announcements lose their impact. Set a recurring calendar reminder to review and refresh the announcement list monthly or after major team events.
4. Use announcements for onboarding - New team members benefit from announcements that link to setup guides, coding standards documentation, and key internal tools. Consider maintaining a separate onboarding-specific announcement set.
5. Coordinate with existing communication channels - Announcements complement but should not replace Slack, email, or wiki updates. Use Claude Code announcements for context-specific reminders most relevant during active development.

Common Issues

1. Announcements not appearing - Verify that the companyAnnouncements array is properly formatted as valid JSON. A missing comma or unclosed quote will silently prevent display.
2. Too many announcements cause information overload - Limit the array to three to five messages. Developers who see a wall of text on every session start will learn to ignore all announcements.
3. URLs in announcements are not clickable - Depending on your terminal emulator, URLs may or may not be clickable. Include shortened URLs or explicit instructions for maximum compatibility.