Skip to main content
The plugin adds the Agentic ID MCP tools, six skills, one agent, four commands, three hooks and the agentic-id CLI to Claude Code. Requirements: Node.js 18 or later. The plugin installs no packages.

Install

Claude Code asks for the plugin options when you enable it. All four are optional.

Options

To change an option later, run /plugin configure agentic-id@icustomer, or open /plugin, select Agentic ID on the Installed tab and choose Configure options.

Sign in

1

Start sign-in

Type /agentic-id-login, or run agentic-id login in a terminal. Your browser opens the sign-in page.
2

Return to Claude Code

When the page says you are signed in, go back to Claude Code. The session is stored in ~/.agentic-id/session.json, readable by you only, and renews itself for 30 days.
3

Check

Type /agentic-id-status. It says which workspace you are connected as.
Skip sign-in if you set an API key. agentic-id logout ends the session.
Never paste an API key into the chat. A key goes in the plugin options. The skills tell Claude never to ask for one.

How spending confirmation works

Three checks apply to every paid call, in this order. The worst case of a call is its max_credits, or the list-price estimate when it has none. These calls always pass: facts, ledger, estimate, status, workspace, report, login, discover with count_only, and list with dry_run or the report action. Each call is also capped by its own max_credits, which the API never exceeds. See Credits.

What ships

Skills

Agent

Commands

Hooks

CLI

The plugin puts the agentic-id command on the PATH of shells that Claude Code starts. See CLI.

What the plugin sends and stores

Network. The plugin talks only to the API at the URL in the Agentic ID API URL option. It sends the arguments of each call, your credential as a Bearer token, and the header x-agentic-id-client: agentic-id-plugin/<version>. Held back on your machine. Personal email addresses, phone numbers and malformed input are dropped before any call. The answer says how many were held back. Local files, all in ~/.agentic-id (or the folder in AGENTIC_ID_CONFIG_DIR): The usage log is not the billing record. For spend, use /agentic-id-usage or the agentic_id_workspace tool.

Errors you may see

Full list: Errors.