> For the complete documentation index, see [llms.txt](https://pharaoh.so/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pharaoh.so/docs/setup/claude-code.md).

# Claude Code

Connect Pharaoh to Claude Code so it sees your codebase architecture in every conversation.

**Prerequisite:** [Install the GitHub App](/docs/setup/github-app.md) first.

## Setup

Run one command:

```bash
npx @pharaoh-so/mcp
```

This handles everything: authenticates via GitHub, registers Pharaoh as a global MCP server, and installs all development skills. Safe to re-run — it resets and reinstalls fresh.

### Alternative: Direct SSE (no local process)

If you prefer a direct SSE connection instead of the stdio proxy:

```bash
claude mcp add --transport sse --scope user pharaoh https://mcp.pharaoh.so/sse
```

## Verify

Start a new conversation and ask:

```
What modules does this codebase have?
```

Claude should call `get_codebase_map` and return a module breakdown with file counts, function counts, and dependency relationships.

## What happens automatically

* Claude calls Pharaoh tools before making architectural decisions - checking for duplicate functions, understanding callers, mapping module boundaries
* Every push to your default branch refreshes the graph within minutes
* No config files or per-repo setup needed after the initial install
* Pharaoh tools return structured data in minimal tokens so Claude has room to reason

## Troubleshooting

**"No repos found" or empty results:** The GitHub App must be installed on the correct org or account. Go to [github.com/apps/pharaoh-so/installations/new](https://github.com/apps/pharaoh-so/installations/new) and verify the installation covers the repos you expect.

**OAuth fails or redirects to an error:** Authorize with the same GitHub account that has the Pharaoh app installed. If you have multiple GitHub accounts, check which one is signed in.

**Connection drops or tools stop responding:** Re-run setup (it removes stale entries automatically):

```bash
npx @pharaoh-so/mcp
```

**Tools not appearing in conversation:** Start a new conversation after adding the MCP server. Existing conversations don't pick up new servers.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pharaoh.so/docs/setup/claude-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.