---
title: Set up Turn Zero Tools in terminal Claude Code
description: Add Turn Zero in terminal Claude Code, sign in, and verify the connection.
slug: /getting-started/set-up-claude-code
order: 1
visibility: public
redirects_from: []
---

# Set up Turn Zero Tools in terminal Claude Code

Before adding or changing a connection, check whether `start` works and the tzTrack or tzMesh tools you need are available. Reuse a working `turnzero` connection. Ask once before changing the setup. If the person uses the Claude desktop app or hasn't named a Claude surface, offer both routes in that message. This route starts sign-in in terminal Claude Code. The [custom connector](/tztools/getting-started/set-up-claude-desktop/) starts sign-in from Claude settings and covers desktop chat, the Code tab and claude.ai.

Use `https://turnzero.ai/mcp`, named `turnzero`, for Claude Code and Codex. This connection provides tzCloud, tzTrack and tzMesh tools within your account’s access. A desktop or editor that shares the CLI configuration reuses it; add no second connection there.

Reuse an existing connection that provides the tools you need. Before changing it, check its address and whether your current session can load its tools.

For a picture, call `generate_image` with a prompt. You need no application. The picture stays in your account for seven days; download it before then. [Generate an image with your AI assistant](https://turnzero.ai/cloud/guides/generate-an-image-from-your-ai-tool/) explains the download link and how to renew it.

1. After approval, you or the person can add `turnzero` from a terminal. The user scope makes it available across project folders.

   ```text
   claude mcp add --transport http --scope user turnzero "https://turnzero.ai/mcp"
   ```

2. The person opens a new interactive terminal session with `claude`, types `/mcp`, and chooses `turnzero`. The person completes browser sign-in and chooses **Allow access** if asked. Keep tokens and callback URLs out of chat.
3. Run `claude mcp get turnzero` after sign-in. Look for **Connected**. Check that the saved address is `https://turnzero.ai/mcp`.

The session that added the server cannot load the new tools. Report the tool check as pending and give the person the prompt below. In a Claude Code 2.1.316 macOS test, a new desktop Code tab session loaded the user-scoped tools after terminal sign-in, even though the desktop app's `/mcp` settings did not list the server.

To switch to the custom connector, first remove the terminal entry with `claude mcp remove turnzero`. Keep one connection.

## Check in a new session

Open a new terminal or desktop Code tab session and paste:

```text
Check my Turn Zero connection. Call start, then check that tzTrack and tzMesh tools are available. If a call fails or a tool is unavailable, tell me what happened.
```
