---
title: "Install the claude-tp helper"
method: POST
path: "/v1/claude-code/install"
tags: ["Claude Code"]
---

# Install the claude-tp helper

`POST /v1/claude-code/install`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/claude-code/install`
- Auth: HTTP bearer

Installs the bundled claude-tp helper and mints a developer bearer token.

## Request body

- object
  - `label` string: Bearer label

## Response `201`

Installed

- object
  - `installedPath` string, required
  - `binaryTarget` string, required
  - `configPath` string, required
  - `bearerId` string, required
  - `previousBearerRevoked` boolean, required
  - `pathCheck` object, required
    - `onPath` boolean
    - `shellRcHint` string, nullable
  - `verification` object, required
    - `ranVersionCheck` boolean
    - `exitCode` integer
    - `version` string
  - `nextSteps` string[], required

## Other responses

- `400`: Invalid request
- `409`: Another mutation in flight

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)