Skip to main content

Claude Code Setup

Claude Code is the more technical Claude-based path for Automation Agent.

If you want to use it inside the desktop app, install Claude Desktop first and then use the Code tab.

This page is for the Codex / Claude Code mode in the Automation Agent panel, which uses the panel-managed local HTTP MCP server.

Use this path when you want Claude Code as the Assistant that inspects Premiere project state through MCP, validates Runtime DSL, and runs permission-scoped workflows with the Automation Agent guidance layer installed.

Claude Code CLI can also be configured as Workflow AI. In that role, a saved workflow can call claude later from an askAgent step.

If the two roles are new to you, read AI Setup Roles first.

Claude Desktop Code tab

Important clarification:

  • the Claude Desktop app currently has three tabs: Chat, Cowork, and Code
  • the Code tab is Claude Code running inside the Desktop app
  • Claude Code is also available outside the Desktop app, including the terminal and IDE integrations
  • the Chat tab uses the separate Claude Desktop local-extension path
  • the Cowork tab is currently not a supported local Automation Agent workflow

For the most stable Claude-based local MCP workflow, use Claude Code with the panel-managed local HTTP MCP server.

Use Claude Desktop Chat Setup only when you specifically need MCP in the Chat tab of Claude Desktop.

This page applies whether you use Claude Code in the Code tab of the Desktop app, in the terminal, or through IDE integrations.

Which Role Does This Set Up?​

RoleSupported with Claude?What needs to be configured
AssistantyesClaude Code MCP config plus the Automation Agent Claude Skill where your Claude surface supports Skills
Workflow AIyes, through Claude Code CLIclaude executable, claude auth login, provider profile, and provider test

Important naming detail:

  • Claude Desktop Code tab is an Assistant surface.
  • Claude Code CLI is the command-line provider Automation Agent uses for Workflow AI.
  • Installing Claude Desktop does not automatically mean the claude CLI is installed and authenticated.

What You Need​

For Claude Code as your Assistant, these things need to be true:

  1. the local Automation Agent MCP server is available
  2. Claude Code has an MCP server entry for Automation Agent
  3. where your Claude Code surface supports Claude Skills, Claude has the Automation Agent Claude Skill installed as the guidance layer

The current panel workflow covers the required config and export access:

  • MCP configuration for Claude Code
  • access to the generated automation-agent-claude-skill.zip artifact for Claude skill installation

For Claude Code CLI as Workflow AI, these things need to be true:

  1. the claude command-line tool is installed
  2. Claude Code CLI is authenticated with claude auth login
  3. Automation Agent has a saved Claude Code CLI Workflow AI provider profile
  4. the provider test passes in AI Setup

Best Setup Path​

The easiest setup path is from inside the Automation Agent panel:

  1. open AI Setup
  2. click Start Guided Setup
  3. choose Anthropic / Claude
  4. follow the Claude Assistant and Claude Code CLI Workflow AI steps

The manual Assistant setup path is:

  1. open the MCP Server tab
  2. start or connect MCP
  3. open the Agent Setup section
  4. use Set Up in the Claude Code card to install or update the MCP config
  5. use Open Claude Skill Export in the Claude Code card and install automation-agent-claude-skill.zip in Claude under Customize > Skills if your Claude Code surface supports Skills
  6. restart Claude Code
  7. return to the panel and verify the status

For Workflow AI, use AI Setup > Workflow AI or Advanced Provider Setup:

  1. find or select the claude executable
  2. run claude auth login if the CLI is not authenticated yet
  3. use Test & Save

Important:

  • use the panel in Codex / Claude Code mode
  • that mode uses the panel-managed HTTP MCP server
  • this is different from Claude Desktop Chat, which uses a client-launched local stdio runtime

The Claude Skill is the guidance layer. It teaches Claude how to use Automation Agent correctly, including when to inspect first, how to author valid DSL, and how to avoid drifting into invented function names or argument shapes.

You do not need the .mcpb desktop extension for Claude Code. The .mcpb file is only for the Claude Desktop Chat tab / stdio workflow.

Where The MCP Config Lives​

For Claude Code, the same config model applies in the terminal and in the Code tab of the Claude Desktop app.

The panel currently installs Claude Code using user scope in:

~/.claude.json

The relevant Automation Agent entry looks like:

{
  "mcpServers": {
    "automation_blocks": {
      "type": "http",
      "url": "http://127.0.0.1:53125/mcp"
    }
  }
}

Scope Notes​

Claude Code supports multiple MCP scopes:

  • local: stored in ~/.claude.json under the current project path
  • project: stored in .mcp.json in the project root
  • user: stored in ~/.claude.json and available across projects

For now, the Automation Agent panel writes the safer user-scope entry so users do not need to manage project-specific Claude config files manually.

Where The Claude Skill Comes From​

The Automation Agent panel also ships the generated Claude skill export:

automation-agent-claude-skill.zip

Use Open Claude Skill Export in the panel to reveal the Claude Skill ZIP, then install that ZIP in Claude via:

  1. Customize
  2. Skills
  3. +
  4. Upload a Skill

The same Claude Skill package is used as the guidance layer for Claude surfaces that support skill upload, including Claude Code.

Workflow AI Notes​

Claude Code CLI Workflow AI is used by saved workflows, not by the Claude Desktop chat tab.

For example, a saved workflow might use Premiere and Automation Agent blocks to collect project data, then call Claude Code CLI only for a bounded reasoning step such as classifying transcript chunks, producing review notes, or returning structured text.

If a provider test fails, check:

  • the selected claude executable path
  • that claude auth login has completed
  • whether Claude Code CLI can be run from the same user account that runs Automation Agent

If Claude Code Was Already Open​

Restart Claude Code after installing or updating the MCP config or, where supported, the Claude Skill. Otherwise it may continue using the previous MCP state or older skill instructions.