|Docs

Claude Code Plugin

The Railway plugin for Claude Code provides skills, hooks, and tooling for managing Railway projects and deployments directly from your terminal.

The plugin is distributed through Claude Code's plugin marketplace system and installs the use-railway agent skill along with supporting scripts and hooks.

Prerequisites

Installation

  1. Add the Railway marketplace

    From within Claude Code, add the Railway plugin marketplace:

    This registers the Railway marketplace and makes the plugin available to install.

  2. Install the plugin

    Install the Railway plugin from the marketplace:

    You can also browse and install through the interactive plugin manager by running /plugin and navigating to the Discover tab.

After installation, the plugin's skills are available in your Claude Code session. Ask your assistant to deploy services, check project status, manage environments, or perform any of the tasks covered by the use-railway skill.

Update the plugin

To update to the latest version, refresh the marketplace and reinstall:

You can also enable auto-updates for the marketplace through the /plugin interface under the Marketplaces tab.

What's included

The plugin installs the following components:

  • use-railway skill - A route-first agent skill that covers project setup, deployments, troubleshooting, environment configuration, networking, observability, and more. See Agent Skills for the full list of capabilities. The skill includes action-oriented reference documents and a GraphQL API helper script for authenticated Railway API requests.
  • Auto-approve hook - A PreToolUse hook that automatically approves Railway CLI commands and Railway API script calls, so Claude Code doesn't prompt for permission on every Railway operation.

Alternative installation

If you prefer to install the agent skill without the Claude Code plugin system, you can use the general-purpose installer that works across multiple AI coding assistants:

See Agent Skills for more details.

Source

The Railway Claude Code plugin is open-source and available on GitHub.