Skip to main content
When you run craft for the first time, you’ll be guided through a setup wizard that configures your authentication and workspace connection.

​
Run the Craft Agents app

Start craft on the command line / terminal: 
craft

​
Setup Steps

The wizard walks you through these configuration steps:
1

Sign in to Craft

A browser window opens for you to sign in to your Craft account. After authenticating, you’re automatically redirected back to the terminal.
2

Choose your Craft space

Select which Craft space to connect from your available spaces. Craft Agents will automatically create a connection to access your documents.
If your space already has MCP connections configured, you’ll be asked to select one or create a new one.
3

Set up billing

Choose how to pay for Claude AI usage:
OptionDescription
Craft CreditsUse your Craft subscription’s AI credits - simplest option
Anthropic API KeyUse your own key from console.anthropic.com
Claude Pro/MaxUse your existing Claude subscription
Craft Credits are the easiest way to get started - no additional setup required. You can purchase credits directly through the app and they’ll be used for all your AI interactions.
If you have the ANTHROPIC_API_KEY environment variable configured, Craft Agent will detect and use it automatically.Otherwise, paste your API key when prompted:
Enter your Anthropic API key: sk-ant-api03-...
Your key is stored securely in an encrypted file at ~/.craft-agent/credentials.enc.
If you have a Claude Pro or Max subscription, you can use it with Craft Agents. This requires the Claude CLI to be installed.Setup:
  1. Install the Claude CLI: npm install -g @anthropic-ai/claude-code
  2. Select “Claude Pro/Max” in the billing options
  3. A browser window opens for authentication
If you have previously authenticated with the Claude CLI, Craft Agents can use your existing token automatically.
4

Ready to go!

Once setup completes, you’ll see the chat interface with:
  • A prompt where you can type messages or commands
  • A status bar showing your connection, billing method, model, and workspace
Type a message to start chatting, or /help to see available commands.
Once you’re comfortable with the basics, try creating custom agents—just write instructions in a Craft document and it becomes a working agent.
To reconfigure everything from scratch, run craft and type /logout. This removes all settings and credentials.

​
Next Steps

Start your first conversation

Learn what you can ask and how to interact with your documents.