> 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/connect/claude-code.md).

# Claude Code: terminal and desktop

Choose the instructions for the surface you use. Claude Code in a terminal and Code sessions in the Claude desktop app have different connection flows.

## Terminal

Run this in the environment where you use Claude Code:

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

Follow the GitHub sign-in steps. The installer registers Pharaoh and its plugin commands for Claude Code. Start a new session if an existing session has not picked up the configuration.

## Code in the desktop app

Open Claude's account Settings > Connectors and add a custom connector:

* Name: `Pharaoh`
* Server URL: `https://mcp.pharaoh.so/mcp`
* Transport, if requested: Streamable HTTP

Complete GitHub sign-in, then open a Code session and ask it to use Pharaoh. Leave other connector settings at their defaults.

### WSL

First ask Claude whether Pharaoh's tools are available in the current session, then request a codebase map. A disabled session-level Connectors menu does not establish whether an existing account connector is available.

Remote connectors are attached to your Claude account. If terminal or connector controls are unavailable, check for app updates and follow [Claude's WSL troubleshooting](https://code.claude.com/docs/en/desktop-wsl#if-the-terminal-or-connectors-are-unavailable). Availability can depend on your account and provider. Changing from Ubuntu to Windows also changes where commands run; confirm the existing connector before changing your development environment.

## Confirm the connection

Ask: “Use Pharaoh's get\_codebase\_map for owner/repo and show the last refreshed time.” A successful result confirms access. If it fails, follow [connection checks](/docs/use-pharaoh/troubleshooting.md).

You can request MCP tools by name in chat. They are not slash commands. The terminal plugin provides commands such as `/pharaoh:plan` and `/pharaoh:review`; MCP prompt availability depends on the client's prompt picker.