Getting Started with the Claude Code Connector

Install and configure the Clarity Forge connector for Claude Code in about a minute.

Prerequisites

Before you begin, make sure you have:

• Node.js 20 or later installed on your system
• Claude Code 2.1.63 or later installed and working
• A Clarity Forge account on the Professional plan

Installation

Install globally (recommended)

npm install -g @clarityforge/cf-claude

Once installed globally, you can run cf-claude from anywhere on your system.

Run without installing

If you prefer to try it first without installing:

npx @clarityforge/cf-claude

This downloads and runs the latest version each time, without permanently installing it.

First Run

The first time you run the connector:

1. Authentication - The connector opens a browser window automatically
2. Sign in - Use your Clarity Forge account credentials
3. Select workspace - Choose which workspace you want to work in
4. Done - That's the setup!

The connection to the Clarity Forge MCP server is handled by the CLI from there, with nothing for you to configure.

What Happens Next

After authentication:

• Your project's knowledge and skills load automatically at the start of each session
• You'll see your agent roster and task queue
• The connector syncs results back to Clarity Forge when sessions complete
• Agents watch for @mentions in discussions while running

Resources

• npm package - Latest version, changelog and stats
• Documentation - Full connector documentation
• FAQ - Common questions in the "Claude Code Connector" section

Troubleshooting

If you run into issues:

1. Check your Node.js version - Run node --version to confirm it's 20 or later
2. Update Claude Code - Make sure you're running version 2.1.63 or later
3. Verify your plan - The connector requires a Professional plan or higher
4. Check authentication - Re-run cf-claude to trigger re-authentication if needed

For additional help, check the FAQ page or contact support at support@clarityforge.com.