---
title: "CLAUDE.md"
description: "CLAUDE.md is a markdown file of instructions that Claude Code reads at the start of every session, giving it persistent context for a project, your personal workflow or an organization."
canonical: "https://agentdrive.sh/glossary/claude-md"
---
# CLAUDE.md

> For the complete documentation index, see [llms.txt](https://agentdrive.sh/llms.txt). Every docs page is also served as markdown at its URL plus `.md`, and the full docs are in one file at [llms-full.txt](https://agentdrive.sh/llms-full.txt).

> CLAUDE.md is a markdown file of instructions that Claude Code reads at the start of every session, giving it persistent context for a project, your personal workflow or an organization.

Source: https://agentdrive.sh/glossary/claude-md. Part of the AgentDrive glossary: https://agentdrive.sh/glossary.

A project CLAUDE.md lives at `./CLAUDE.md` or `./.claude/CLAUDE.md` and is shared through version control; a personal one at `~/.claude/CLAUDE.md` applies to all your projects. Typical contents are build and test commands, coding standards, architecture decisions and naming conventions. Claude Code treats the file as context, not enforced configuration, and can read a repository's AGENTS.md in its place.

## In AgentDrive

AgentDrive does not read or edit CLAUDE.md. In Claude Code, its plugin ships an `agentdrive` skill instead. CLAUDE.md holds what you write down for every session, while AgentDrive syncs what each session did, so another agent can resume it.

## Related terms

- [AGENTS.md](https://agentdrive.sh/glossary/agents-md/index.md): AGENTS.md is an open format for guiding coding agents: a markdown file, usually at a repository's root, that holds the instructions an agent needs to work in that project.
- [Coding agent](https://agentdrive.sh/glossary/coding-agent/index.md): A coding agent is an AI tool that works through a software task in a code repository: it reads and edits files, runs commands such as tests, and reports back.
- [Session sync](https://agentdrive.sh/glossary/session-sync/index.md): Session sync copies a coding-agent session from the machine it runs on into a shared workspace as it happens, so another agent or another machine can read and resume it.

## Go deeper

- [AgentDrive vs CLAUDE.md and handoff notes](https://agentdrive.sh/compare/claude-md-handoff-notes)
- [Claude Code integration](https://agentdrive.sh/integrations/claude-code)

## Official source

- [Claude Code docs: How Claude remembers your project](https://code.claude.com/docs/en/memory)

