Claude Code + Nuon
Claude Code is Anthropic's agentic coding tool that operates directly in your terminal. With the Nuon plugin, MCP server, and agent skills, it can package BYOC apps, manage installs, and run day-2 operations.
Quick Start
Get started in 4 steps
Install Claude Code
npm install -g @anthropic-ai/claude-code Install the Nuon Plugin
claude plugin add nuonco/nuon-plugin Install Nuon MCP Server
claude mcp add nuon -- uvx nuon-mcp serve Start building
claude Then ask: "Create a Nuon app config for my Helm chart"
Example Prompts
What you can ask Claude
"Create a Nuon app config for my Helm chart"
"Add a health check action to my app"
"Deploy my app config with nuon apps sync"
"Create an OPA policy to require image signing"
"List all my installs and their deployment status"
"Generate a component diagram for my app"
"Add a database migration action that runs post-deploy"
"Teardown the staging install"
Nuon Skills
Agent skills for Claude Code
Claude Code supports Agent Skills natively. Install Nuon skills to give Claude deep knowledge of BYOC app configuration, actions, and policies.
App Config Generator
Guided interview that produces validated TOML app configs — sandboxes, components, inputs, and dependencies.
npx skills add nuonco/agent-skills@nuon-app-config Actions Creator
Day-2 operation scripts: health checks, database migrations, diagnostics, and secret management.
npx skills add nuonco/agent-skills@nuon-actions Policy Creator
OPA/Rego compliance policies for container images, Terraform modules, and Helm charts.
npx skills add nuonco/agent-skills@nuon-policy Nuon Creator
Entry point that understands your intent and routes you to the right specialist skill.
npx skills add nuonco/agent-skills@nuon-creator Common Workflows
What you can build with Claude + Nuon
Package a new BYOC app
- 1. Ask Claude to create a Nuon app config from your existing Helm chart or Terraform module
- 2. Claude uses the App Config skill to interview you and generate validated TOML
- 3. Claude runs nuon apps sync to deploy the config
- 4. Claude validates the build completes successfully
Create and deploy an install
- 1. Ask Claude to create an install for your app
- 2. Claude uses the MCP server to call create_new_install
- 3. Claude configures inputs and triggers a deployment
- 4. Claude monitors deployment status until complete
Add day-2 operations
- 1. Ask Claude to add a health check or migration action
- 2. Claude uses the Actions skill to generate TOML action scripts
- 3. Claude syncs the updated config with nuon apps sync
- 4. Claude tests the action manually via the MCP server
Set up compliance policies
- 1. Ask Claude to create an OPA policy for image signing or resource limits
- 2. Claude uses the Policy skill to generate Rego rules and policies.toml
- 3. Claude applies policies to target components
- 4. Claude verifies enforcement on the next build or deploy
Debug a failed deployment
- 1. Ask Claude to check your install status
- 2. Claude uses the MCP server to fetch deployment details and logs
- 3. Claude analyzes errors and suggests fixes
- 4. Claude applies the fix and triggers a redeploy
Tips for Success
Get the most out of Claude + Nuon
nuon CLI alongside Claude for quick checks and verification Troubleshooting
Common issues and fixes
MCP server connection fails
Run claude mcp list to verify the Nuon MCP server is installed. Re-add with claude mcp add nuon -- uvx nuon-mcp serve.
Plugin not found
Run claude plugin list to check installed plugins. Re-add with claude plugin add nuonco/nuon-plugin.
Authentication error
Run nuon auth login to re-authenticate, or verify your API token in ~/.nuon config.
Related
Nuon works with all major AI coding agents
Offer BYOC for any deployment architecture
Start your Nuon trial and try our example apps in minutes. No credit card required.