# companyAnnouncements

> The key that shows company messages when Claude Code starts.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** companyAnnouncements setting

## Think of it like

It is like a note pinned to the office door. Everyone sees it on the way in.

## Definition

companyAnnouncements is a settings key that shows a company's messages to people when Claude Code starts. It is a list of strings. With more than one, Claude Code picks one at random each session. On a person's very first start, it shows the first one. Left unset, no message shows.

## Example

Jack's boss wants all staff to read the AI rules. IT puts a link in companyAnnouncements, and each person sees it at the start.

## Example code

```json
{
  "companyAnnouncements": [
    "Read the AI policy at wiki.acme.com/ai",
    "Ask in #claude-help if you get stuck"
  ]
}
```

Show one of these notes at each start.

## Why it matters

It reaches each person just as they start work, not in an email they may skip.

## Common mistake

Expecting the order to stay fixed. After the first start, one is picked at random.

## Three principles

- **Shown at start.** Each session.
- **Random pick.** If many.
- **First one first.** On day one.

## Related terms

- [Managed Settings File](https://learn.benibix.com/term/ai/managed-settings-file)
- [Claude Code Settings File](https://learn.benibix.com/term/ai/claude-code-settings-file)

---

Source: https://learn.benibix.com/term/ai/company-announcements-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
