# Claude Code

Drop our agent skills into Claude Code so the model knows how to wire up Address Finder, Postcode Lookup, the API, and the CLI without trial-and-error.

## Install[​](#install "Direct link to Install")

One command, from inside your repo:

```
npx skills add ideal-postcodes/skills
```

This installs four skills under `.claude/skills/`:

* `address-finder` — multi-country address autocomplete widget
* `postcode-lookup` — UK postcode → address dropdown
* `api` — direct HTTP integration
* `idpc-cli` — non-interactive CLI for account, key, and address operations

Skills load automatically when Claude Code opens the repo.

## Verify[​](#verify "Direct link to Verify")

Ask Claude Code:

```
What's the npm install command for the Ideal Postcodes Address Finder?
```

The skill should produce `@ideal-postcodes/address-finder` without prompting you to search the web.

## API key[​](#api-key "Direct link to API key")

* Quick test: `ak_test` (capped at 5 lookups/day, public, breaks in production).
* Real key: [sign up](https://ideal-postcodes.co.uk/signup) for a free trial balance.
* Before deploy: restrict the key via [Allowed URLs](/docs/guides/allowed-urls.md).

## Going deeper[​](#going-deeper "Direct link to Going deeper")

* Skills source: [github.com/ideal-postcodes/skills](https://github.com/ideal-postcodes/skills)
* Full agent hub: [Build with AI](/docs/guides/llms.md)
* Full reference as one file: [llms.txt](https://docs.ideal-postcodes.co.uk/llms.txt)

## Need help?[​](#need-help "Direct link to Need help?")

* File an issue: [github.com/ideal-postcodes/feedback](https://github.com/ideal-postcodes/feedback/issues)
* Email: <support@ideal-postcodes.co.uk>