← All connection guides

How to connect Claude Code to Higgsfield.ai

Connect Claude Code to Higgsfield using its official skills and CLI, with account checks and a complete generation test.

Free guide · Updated

Based on official documentation · Checked

Ask your agent

Copy the prompt and paste it into your assistant.

Quick answer

Use the official Higgsfield skills in a local Claude Code session. The skill provides instructions, while the Higgsfield CLI authenticates and submits work. This route differs from adding a connector to Claude web or desktop.

Before you start

Prepare Claude Code, Node.js/npm, and a Higgsfield account with access to the model you intend to use. Work in a disposable project. Check workspace credits before requesting a generation; a Claude subscription does not establish that a separate service is paid for.

1. Install and sign in

Install the CLI using its documented npm route. Complete the browser sign-in yourself. Keep credentials out of the chat.

npm install -g @higgsfield/cli
higgsfield auth login

2. Add the agent skills

Run the official cross-agent installer and select Claude Code if prompted. Review local versus shared installation scope. Start a new session after installation so the client can discover the skill.

npx skills add higgsfield-ai/skills

3. Check discovery before generation

Ask Claude Code to identify the installed Higgsfield generation skill and describe the intended action. Finding a Markdown file is insufficient: the same session must be able to invoke the CLI. Use the terminal client for this setup.

Practice

4. Verify a complete request

  1. Ask Claude Code to create one image of a red paper boat on a plain background using the installed Higgsfield skill. Have it confirm the model and cost before submitting one job.

Output: A completed job, an accessible image, and the actual command invoked by Claude Code.

5. Inspect the result

Open the returned image and check that it matches the task. Open a fresh Claude Code session and repeat discovery and a read operation; a second paid image is unnecessary if the first outcome is conclusive.

Troubleshooting

Skill absent: review which client and installation scope were selected, then restart the session. Executable absent: confirm the shell used by Claude Code can locate Higgsfield. Authentication failure: repeat interactive login for the intended account. Model failure: inspect the current catalog instead of inventing an identifier. A timeout requires inspection of the existing job before resubmission.

Disconnect and limits

Remove only the skill installation created for this test. Use the installed CLI help to confirm logout and account revocation steps. Close your own login tabs and helpers. This guide covers Claude Code CLI plus skills. Claude web and desktop use a different connector setup.

Sources

Read the primary material