n8n-nodes-code-build

This is an n8n community node that provides AI-powered code building capabilities. It lets you automate code development, modification, and building directly from your n8n workflows.

Current Support: Claude Code

Coming Soon: I'm actively working on adding support for other AI coding platforms including Codex. For now, this node works with Claude Code, but additional providers will be added in future updates.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Prerequisites
• Credentials
• Operations
• Compatibility
• Resources
• License

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-code-build in the Enter npm package name field
4. Click Install

Alternatively, if you're self-hosting n8n:

npm install n8n-nodes-code-build

Prerequisites

Before using this node, you need:

1. A GitHub account with a personal access token
2. A Claude API key (for API authentication) or Claude subscription access token (for subscription authentication)
3. Access to Claude's API or subscription service

Credentials

To use this node, you'll need to configure the Code Build API credentials in n8n:

| Field | Description | Required | | ---------------------- | ---------------------------------------------------- | -------- | | GitHub Token | Your GitHub personal access token | Yes | | Provider | AI provider to use (default: Claude Code) | Yes | | Authentication Type| API Key or Subscription | Yes | | API Key | Your Claude API key (if using API authentication) | Conditional | | Access Token | Your Claude subscription access token (if using subscription) | Conditional |

Setting Up GitHub Token

1. Go to GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)
2. Click Generate new token > Generate new token (classic)
3. Give your token a descriptive name (e.g., "n8n Code Build")
4. IMPORTANT: Select the following permissions:
   • ✅ repo (Full control of private repositories)
   • ✅ workflow (Update GitHub Action workflows)
5. Click Generate token
6. Copy the token immediately (you won't be able to see it again!)

Setting Up Claude Authentication

Option 1: Using API Key

If you want to use Claude's API:

1. Go to the Anthropic Console
2. Navigate to API Keys
3. Click Create Key
4. Copy your API key
5. In the n8n credential:
   • Select Authentication Type: API Key
   • Paste your API key in the API Key field

Option 2: Using Subscription (Claude Code)

If you have a Claude subscription and want to use Claude Code:

1. Install Claude Code if you haven't already
2. Run the following command in your terminal:

   claude setup-token

3. This will generate an access token
4. Copy the access token from the output
5. In the n8n credential:
   • Select Authentication Type: Subscription
   • Paste your access token in the Access Token field

How to Add Credentials

1. In your n8n workflow, add the Code Build node
2. Click on Credential to connect with
3. Select Create New
4. Enter your credentials:
   • GitHub Token: Your GitHub personal access token (with repo and workflow permissions)
   • Provider: Claude Code (default)
   • Authentication Type: Choose API Key or Subscription
   • API Key or Access Token: Enter based on your authentication choice
5. Click Save

Operations

The Code Build node automates the complete setup of a GitHub repository with Claude integration.

Build

Creates a new GitHub repository with Claude AI integration fully configured.

Parameters:

• Owner: The GitHub repository owner (username or organization)
• Repository Name: The name for the new repository
• Private Repository: Whether the repository should be private (default: true)
• Prompt: Instructions for Claude to execute

What This Node Does:

This node sets up Claude Code on your repository and runs your prompt on a GitHub Actions runner. Claude will build the code based on your prompt and automatically commit and merge it into the main branch.

The node automatically:

1. Creates a GitHub Repository

   • Creates a new repository with the specified name
   • Sets privacy level (public/private)
   • Initializes with a README

2. Configures Claude Integration

   • Adds the appropriate secret (ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN)
   • Creates the GitHub Actions workflow file
   • Creates an issue with your prompt to trigger Claude

3. Executes Your Prompt

   • Claude Code runs on a GitHub Actions runner
   • Builds the code based on your prompt
   • Automatically commits and merges changes to main branch

Example:

Input:

• Owner: myusername
• Repository Name: my-new-app
• Private Repository: true
• Prompt: Create a React application with TypeScript and Tailwind CSS

Result:

• Repository created at github.com/myusername/my-new-app
• Claude Code configured and running
• Your app is built and committed automatically

Compatibility

• n8n version: 0.220.0 or higher
• Tested with: n8n 1.0+

Version History

0.1.0

• Initial release
• Basic credential setup for GitHub token and Claude authentication
• Support for both API key and subscription authentication
• Claude Code provider integration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• n8n Community Forum

Author

Joshua Riley

• Email: [email protected]
• GitHub: @joshuarileydev

License

MIT

Disclaimer

This is a community-developed node and is not officially affiliated with or endorsed by Anthropic or GitHub. Use at your own risk.