ComfyUI Node: Claude Code Execute

Claude Code Execute:

ClaudeCodeExecute is a versatile node designed to execute commands within the Claude Code framework, offering modular configuration and real-time progress reporting. This node is particularly beneficial for AI artists who need to automate tasks or execute complex command sequences without delving into intricate coding details. By leveraging ClaudeCodeExecute, you can seamlessly integrate command execution into your workflows, utilizing various tools and configurations to tailor the execution process to your specific needs. The node supports loading commands from files or using custom text inputs, allowing for flexibility in how commands are defined and executed. Additionally, it provides options to configure memory, arguments, and tools, enhancing the adaptability and power of the execution process. With its ability to handle multiple turns and manage outputs efficiently, ClaudeCodeExecute is an essential component for those looking to streamline their creative processes using Claude Code.

Claude Code Execute Input Parameters:

command_source

This parameter determines the source of the command to be executed. You can choose between file and text, where file allows you to load a command from a specified file, and text lets you input a custom command directly. The default value is file, providing flexibility in how commands are sourced.

command_file

This parameter specifies the file from which the command should be loaded when command_source is set to file. It offers a list of available command files from the commands folder, with a default option of [Custom Command] for custom text input. This allows you to easily select and execute predefined commands.

command

This is the actual command to be executed, used when command_source is set to text or when the command file is [Custom Command]. It supports multiline input, allowing you to define complex command instructions. The default value is a placeholder text, encouraging you to input your specific command instructions.

model

This parameter specifies the Claude model to be used for execution. Available options include default, sonnet, and opus, with default being the standard choice. This allows you to select the model that best fits your execution needs, potentially affecting the performance and output of the command.

max_turns

This parameter sets the maximum number of turns Claude can take to complete the task. It accepts integer values ranging from 1 to 512, with a default of 8. This controls the extent of the execution process, allowing you to balance between thoroughness and efficiency.

memory

An optional parameter that provides memory or context from the Claude Memory Builder. It allows you to incorporate previous context into the current execution, enhancing the continuity and relevance of the command execution.

arguments

This optional parameter allows you to pass arguments from the Claude Arguments Builder in JSON format. It enables dynamic customization of the command by replacing placeholders with actual values, making the execution more adaptable to varying requirements.

tools

An optional parameter that specifies the tool configuration from the Claude Tools Config. It includes a list of tools such as Read, Write, Edit, MultiEdit, Bash, Grep, and Glob, allowing you to define which tools are available during execution, thus tailoring the process to your needs.

previous_output

This optional parameter allows you to use the output from a previous Claude Code execution as input for the current execution. It facilitates iterative processes where the output of one execution informs the next, promoting a seamless workflow.

mcp_config

An optional parameter that provides MCP configuration from the Claude MCP Manager. It allows you to set up and manage multiple command processors, enhancing the execution's scalability and complexity handling.

unique_id

A hidden parameter used internally to track and report progress for specific executions. It ensures that progress updates are accurately associated with the correct execution instance.

Claude Code Execute Output Parameters:

output_folder

This parameter provides the path to the folder where the execution outputs are stored. It is crucial for accessing and managing the results of the command execution, ensuring that all outputs are organized and easily retrievable.

execution_status

This parameter indicates the status of the command execution, providing feedback on whether the execution was successful or if any issues were encountered. It helps you quickly assess the outcome of the execution process.

execution_details

This parameter offers a detailed report of the execution process, including any errors or warnings encountered. It is essential for troubleshooting and understanding the specifics of how the command was executed, allowing for informed adjustments and improvements.

Claude Code Execute Usage Tips:

• Ensure that the command_source is set correctly to either file or text based on your needs to avoid execution errors.
• Utilize the arguments parameter to dynamically customize commands, making them more flexible and adaptable to different scenarios.
• Regularly update the command_file list by adding new command files to the commands folder to expand the range of executable commands.
• Use the max_turns parameter wisely to balance between execution thoroughness and time efficiency, especially for complex tasks.

Claude Code Execute Common Errors and Solutions:

Failed to load command file, using custom command

• Explanation: This error occurs when the specified command file cannot be loaded, possibly due to a missing or incorrect file path.
• Solution: Verify that the command file exists in the commands folder and that the file path is correct. Alternatively, ensure that the command_source is set to text if you intend to use a custom command.

Command execution failed

• Explanation: This error indicates that the command could not be executed successfully, possibly due to syntax errors or incompatible configurations.
• Solution: Review the command syntax and ensure that all required parameters are correctly configured. Check for any errors in the command logic or parameter values.

MCP setup errors

• Explanation: This error suggests issues with the MCP configuration, which may prevent proper setup of multiple command processors.
• Solution: Examine the mcp_config parameter for any incorrect settings or missing configurations. Ensure that all necessary MCP components are properly defined and accessible.