---
title: "Usa AGENTS.md in Claude Code e Codex"
description: "Codex legge AGENTS.md di default. Claude Code 2.1.277 o successivo lo legge quando il progetto non ha un CLAUDE.md. Per tenerli entrambi, metti @AGENTS.md nel tuo CLAUDE.md."
canonical: "https://logbrew.co/it/guides/agents-md"
last_updated: "2026-11-10"
---

# Usa AGENTS.md in Claude Code e Codex

Codex legge `AGENTS.md` di default. Claude Code 2.1.277 o successivo lo legge quando il progetto non ha un `CLAUDE.md`. Per tenerli entrambi, metti `@AGENTS.md` nel tuo `CLAUDE.md`.

Testato il 10 novembre 2026 con Claude Code 2.1.319 e Codex CLI 0.167.0

Di [Furkan Erday](https://github.com/furkanerday). Furkan Erday è il fondatore di LogBrew. Sviluppa LogBrew ogni giorno con Claude Code e Codex.

Canonical: https://logbrew.co/it/guides/agents-md

## Quando ogni agente carica `AGENTS.md`

| Il tuo progetto ha | Claude Code | Codex |
| --- | --- | --- |
| Solo `AGENTS.md` | Caricato | Caricato |
| `AGENTS.md` e `CLAUDE.md` | Ignorato | Caricato |
| Un `CLAUDE.md` che importa `@AGENTS.md` | Caricato | Caricato |
| Un `CLAUDE.md` che è un link simbolico ad `AGENTS.md` | Caricato | Caricato |
| `AGENTS.md` e `CLAUDE.local.md` | Ignorato | Caricato |

Abbiamo letto le istruzioni che ogni agente inviava con la prima richiesta.

## Un solo file per entrambi gli agenti

### Scrivi AGENTS.md nella radice del progetto

Metti in 1 file i comandi di build, i comandi di test e le regole sul codice. Entrambi gli agenti lo leggono dalla radice del repository Git fino alla cartella corrente.

### Aggiorna Claude Code

Claude Code legge `AGENTS.md` da solo dalla versione 2.1.277. Le versioni precedenti hanno bisogno dell’import del passaggio successivo.

```bash
claude update
```

### Importa AGENTS.md dal tuo CLAUDE.md

Un `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md` nella tua cartella o più in alto impedisce a Claude Code di leggere `AGENTS.md`. Aggiungi questa riga al tuo `CLAUDE.md` per caricarli entrambi.

```bash
@AGENTS.md
```

### Oppure collega CLAUDE.md ad AGENTS.md

Se il tuo `CLAUDE.md` contenesse solo l’import, trasformalo invece in un link simbolico.

```bash
ln -s AGENTS.md CLAUDE.md
```

### Oppure caricali entrambi con un’impostazione

Per tenere un `CLAUDE.local.md` e caricare comunque `AGENTS.md`, aggiungi questo a `~/.claude/settings.json`. In una sessione, l’opzione per le istruzioni di progetto in `/config` imposta lo stesso valore.

```bash
{
  "pluginConfigs": {
    "cc-plugin-agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}
```

### Controlla cosa ha caricato Codex

Esegui il comando dalla cartella in cui lavori. La documentazione di Codex lo indica per far ripetere a Codex le istruzioni che ha caricato.

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

## Cosa abbiamo visto nei test

Abbiamo collegato entrambi gli agenti a un server di test locale e letto le istruzioni che ognuno inviava con la prima richiesta. Così si vede esattamente quali file carica ogni agente.

Claude Code ha caricato `AGENTS.md` quando il progetto non aveva un `CLAUDE.md`, e il suo log di debug diceva `no CLAUDE.md found; AGENTS.md loaded`. Con un `CLAUDE.md` accanto, Claude Code ha lasciato fuori `AGENTS.md`. Con l’import `@AGENTS.md` o con il link simbolico, il testo di `AGENTS.md` è comparso esattamente una volta.

L’impostazione `pluginConfigs` vista sopra ha caricato entrambi i file, anche con un `CLAUDE.local.md` nel progetto.

Codex ha caricato prima `~/.codex/AGENTS.md`, poi l’`AGENTS.md` nella radice, poi il file nella cartella corrente. Un `AGENTS.override.md` ha sostituito l’`AGENTS.md` nella sua cartella. Codex ha ignorato un `CLAUDE.md` finché non l’abbiamo aggiunto a `project_doc_fallback_filenames`. Quando esistevano entrambi i file, Codex ha caricato solo `AGENTS.md`, anche con il fallback impostato.

## AGENTS.md o CLAUDE.md

Codex legge `AGENTS.override.md` o `AGENTS.md` in ogni cartella, più il file globale `~/.codex/AGENTS.md`, fino a 32 KiB in totale di default. Legge `CLAUDE.md` solo se lo elenchi in `project_doc_fallback_filenames`.

Claude Code legge prima `CLAUDE.md`. Legge `AGENTS.md` e `.claude/AGENTS.md` solo quando non vale nessun `CLAUDE.md` di progetto. Il tuo `~/.claude/CLAUDE.md` personale non conta, quindi viene caricato insieme ad `AGENTS.md`.

## Cosa dicono le segnalazioni su GitHub

La #6235, con 409 commenti, chiedeva il supporto di AGENTS.md in Claude Code. Il 17 agosto 2026 un ingegnere di Anthropic l’ha chiusa indicando l’import e il link simbolico descritti sopra. Ora Claude Code legge il file da solo. La #31005 chiede anche il supporto di `.agents/skills/` ed è ancora aperta.

## Domande frequenti

### Claude Code legge AGENTS.md?

Sì, dalla versione 2.1.277, quando nella tua cartella o più in alto non esiste un `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`. L’abbiamo verificato sulla 2.1.319.

### Meglio AGENTS.md o CLAUDE.md?

Usa `AGENTS.md` se qualcuno nel tuo team usa Codex o un altro agente. Tieni un `CLAUDE.md` solo per le regole che valgono solo per Claude Code, e importa `@AGENTS.md` da lì.

### Posso fare di CLAUDE.md un link simbolico ad AGENTS.md?

Sì. Nel nostro test Claude Code ha caricato il file collegato una volta sola, come con l’import.

### Codex legge CLAUDE.md?

Non di default. Aggiungi `project_doc_fallback_filenames = ["CLAUDE.md"]` a `~/.codex/config.toml`.

## Dai al tuo agente i tuoi errori di produzione

Collega il server MCP di LogBrew e Claude Code o Codex leggerà errori, log e tracce dei progetti che approvi. Inizia con il generoso piano gratuito, senza carta.

[Collega il tuo agente](https://logbrew.co/it/agents)

## Fonti

- [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md)
- [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235)
- [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005)

## Altre guide per gli agenti di coding IA

- [Aggiungi un server MCP a Claude Code e Codex](https://logbrew.co/it/guides/mcp-server-claude-code-codex)
- [Risolvi l’errore overloaded 529 e l’errore di rate limit 429 di Claude](https://logbrew.co/it/guides/claude-overloaded-rate-limit-error)
- [Come risolvere gli errori in Claude Code, Codex e nel JavaScript del browser](https://logbrew.co/it/guides)