How to give Claude Code your team's context, not just your code

Claude Code is the best pair programmer most teams have ever had, as long as the answer is in the file in front of it. On everything around that file it goes blind. It reads your repository fluently and cannot read the Slack thread where you decided to drop the second cache, the Linear ticket explaining why retries are capped at three, or the fact that Priya is the only person who has touched billing since March. The way to give Claude Code your team's context is not a longer CLAUDE.md. It is to connect Claude Code to your team's living context over MCP, so it recalls decisions, owners, and runbooks the same way it recalls code.

This matters because the model is confident either way. Without the why, it will happily reintroduce the exact pattern your team killed six weeks ago, and it will sound right doing it.

What Claude Code already knows, and where it goes dark

Open a session in a repo and Claude Code loads the code, the CLAUDE.md file, your MCP servers, and your skills. That CLAUDE.md earns its place. It is the briefing you would give a sharp new hire on their first morning: how to build, how to test, the conventions, the one or two constraints you have been burned by. Commit it, and the whole team starts from the same setup.

Then you hit the edges.

CLAUDE.md is static. It says what is true today and nothing about how you got here. It also has a practical ceiling. Pile too much into it and instructions start getting dropped, and a fresh session already spends thousands of tokens loading the system prompt and tool definitions before you type a word. So you cannot pour your team's full history into it even if you wanted to.

Worse, the most valuable context never reaches a file at all. When an engineer talks through a tradeoff with Claude Code, rejects two approaches, and picks the third for a specific reason, that reasoning lives in their local session and dies there. Claude Code's auto-memory is per person. Your teammate's Claude Code does not have your debugging session, and three months from now, when someone asks "why is it built this way," the code is all that is left. Code records what was done. It never records why the alternative was rejected.

This gap is well known. There is an open request on the Claude Code repo for shared team memory, precisely because knowledge in real teams flows between people - through handoffs, reviews, investigations - and the current memory model is individual. The building blocks exist. The connective tissue does not.

The fix is a source of truth Claude Code can query

The instinct is to write more down. The better move is to give Claude Code somewhere to look.

MCP, the Model Context Protocol, is the open standard Anthropic shipped in late 2024 for connecting AI to the systems where data actually lives. Think of it as a standard port: a tool exposes an MCP server once, and any MCP client - Claude Code, Cursor, Claude Desktop - can read from it. You already use it for a Linear or GitHub server. The same mechanism can expose your team's knowledge. If you want the protocol itself in plain terms, we cover what MCP means for a team separately.

That is the shape of the answer to Claude Code team context. Instead of flattening your team's history into one overgrown markdown file, you connect Claude Code to a graph it can interrogate: which decisions are live, who owns which surface, how a given procedure runs, what is blocking a workstream right now. The context stops being a snapshot you maintain by hand and becomes something the model pulls on demand.

This is the layer Ody sits in. Ody captures the decisions, context, and runbooks scattered across Slack, Linear, GitHub, Google Docs, standups, and your coding agents into one living team knowledge graph, and it is callable from four places - the web, the CLI, Slack, and MCP. Over MCP, Claude Code and Cursor read that graph directly. The human reading the web app and the agent reading the graph work from the same source of truth, not two drifting copies.

What changes when Claude Code can recall the why

The difference is concrete. Three things move.

It recalls decisions, with the diff and the reason

A decision is not a fact frozen at one point. It is a thing that changes. You capped retries at three, then last month raised the timeout instead and dropped the cap to two after an incident. A wiki page shows you the latest line. A decision log that evolves shows the before, the after, the reason, and the date.

When that log is callable over MCP, Claude Code asking "what is our retry policy" gets the current answer plus the reasoning that produced it. It stops proposing the pattern you already rejected, because it can see that you rejected it and why. A changed decision reads as a change, not a conflict, so the agent inherits the evolution instead of a contradiction it has to resolve from stale comments.

It knows who owns what

Code review with an agent gets sharper when the agent knows the human terrain. "This touches the settlement flush; the only person who has worked on it recently is Marco" is the kind of line that changes how you read a diff. Ody's People view maps who-knows-what from the actual signal - commits, threads, reviews - and surfaces bus-factor risk before anyone gives notice. Surfaced to Claude Code, ownership stops being something you carry in your head and becomes context the agent can route around.

It runs your runbooks, not a generic version

The third time you run a migration the same way, that procedure is a runbook whether you wrote it down or not. Ody turns a repeated procedure into a self-sharpening playbook. Exposed over MCP, Claude Code executing a familiar task follows your steps, your gotchas, your order of operations - not the median approach from its training data, which is fine right up until it is the one that drops the wrong index in production.

A short before and after

Here is the same Tuesday, twice.

Moment Claude Code on code alone Claude Code with team context over MCP
"Why is retry capped at 2?" Infers from code; guesses or hallucinates intent Returns the decision, the prior value, the incident that changed it, the date
Reviewing a risky diff Flags style and obvious bugs Flags that the change touches a bus-factor-1 surface and names the owner
Running a migration Median approach from training data Follows your runbook, including the step that bit you last time
Three months later Context is gone; code is all that is left The why is still queryable, because it was captured when it happened

None of this makes the agent autonomous, and it should not. Ody's core principle is that it senses continuously and automatically but acts only when a human says so. A nudge is the ceiling of its autonomy. It reads only the surfaces you connect, inherits each tool's permissions, and writes nothing back on its own. Giving Claude Code your team's context makes its suggestions match reality. The decision to act stays with you.

How to start, narrow on purpose

You do not need a knowledge-management project for this. The practical path is small by design.

Keep CLAUDE.md for what it is good at - commands, conventions, hard constraints - and stop trying to make it your team's memory. Pick the one workstream where lost context hurts most, usually the one with a single owner and a history of "wait, why did we do it this way." Connect the tools where that workstream's signal already lives. Then let Claude Code read the graph over MCP and ask it the question you would have asked the one person who knows.

The teams that feel this first are the ones around twenty engineers adopting agents fast, where the gap between what the code says and what the team decided widens by the week. That is the gap Ody is built to close, as an execution layer, not search. Glean points you at a document to read. Ody compiles the tickets, chats, and docs into a typed graph your agents can act from.

Ody is in invite-only beta. If your Claude Code keeps making confident suggestions that ignore decisions your team already made, book a demo or join the waitlist. That is the gap worth closing first.

Common questions

Does CLAUDE.md give Claude Code my team's context?

Partly. CLAUDE.md is a static, version-controlled file that loads at the start of every session, so it is good for build commands, conventions, and hard constraints. But it does not hold the why behind decisions, who owns what, or how a procedure actually runs, and it has a practical ceiling: pile too much in and instructions start getting dropped. The decisions made inside a teammate's chat session stay in that session. For living team context, you connect Claude Code to a source of truth over MCP instead of trying to fit everything into one file.

How do I connect Claude Code to team knowledge over MCP?

MCP (Model Context Protocol) is an open standard from Anthropic that lets Claude Code read from external systems through a server. You point Claude Code at an MCP server that exposes your team's knowledge, and the model can query decisions, owners, and runbooks the way it queries files. Ody runs as an MCP server over your team graph, so Claude Code and Cursor read the same source of truth a human would see in the web app or Slack.

Why does Claude Code not know why our code is built a certain way?

Because the reasoning lived in a chat session that is now gone. When an engineer weighs tradeoffs with Claude Code and picks an approach, that rationale stays in their local context. Three months later the code is all that remains, and the code records what was done, never why the alternative was rejected. A decision log that captures the before-to-after change with the reason and date, and exposes it over MCP, is what lets Claude Code recall the why instead of guessing.

Will giving Claude Code team context let it make changes on its own?

Not with Ody. Ody senses continuously but acts only when a human says so; a nudge is the ceiling of its autonomy, and it writes nothing back to your tools on its own. Reading team context makes Claude Code's suggestions match your team's actual decisions. What you do with those suggestions is still your call.