🦞 nyxclaw

Claude Max Sub proxy patcher for OCPlatform — auto-patches @rynfar/meridian for full tool passthrough.

The Problem

Meridian is a proxy that lets you use your Claude Max subscription via API. It works great — except for one thing:

In passthrough mode, Meridian limits the model to 2 turns. This means Claude can only make 2 tool calls before being cut off. For platforms like OCPlatform that rely on multi-step tool use (file edits, shell commands, web searches, etc.), this is a deal-breaker.

The relevant line in Meridian's source:

maxTurns: passthrough ? 2 : 200

The Solution

nyxclaw patches this to:

maxTurns: passthrough ? 1 : 200

Setting maxTurns to 1 in the Claude Code SDK actually means "no artificial limit" — it lets the orchestrating platform (OCPlatform) handle turn management, which is exactly what you want in passthrough mode.

nyxclaw also sets up everything else you need:

• System user for running the proxy
• Sudoers configuration
• systemd service with MERIDIAN_PASSTHROUGH=1
• Auto-start on boot

Installation

npm install -g nyxclaw

Quick Start

# Full setup (install meridian, patch, create user, systemd service)
sudo nyxclaw setup

# Log in to Claude (required once)
sudo -u meridian claude login

# Check that everything is working
nyxclaw status

Commands

nyxclaw setup

Full automated setup. Requires root. Does everything:

1. Installs @rynfar/meridian globally (if not already installed)
2. Patches the maxTurns limit for passthrough mode
3. Creates a meridian system user
4. Configures sudoers for the meridian user
5. Generates a systemd service file with MERIDIAN_PASSTHROUGH=1
6. Enables the service for auto-start on boot
7. Starts the service (if Claude is already logged in)

nyxclaw patch

Re-applies just the maxTurns patch. Useful after updating meridian:

npm update -g @rynfar/meridian
sudo nyxclaw patch
sudo systemctl restart meridian

nyxclaw status

Health check. Shows:

• ✅/❌ Meridian installed
• ✅/❌ Patch applied
• ✅/❌ System user exists
• ✅/❌ Sudoers configured
• ✅/❌ Service running
• ✅/❌ Claude authenticated

How It Works

┌─────────────┐     ┌──────────────────┐     ┌──────────────┐
│  OCPlatform  │────▶│  Meridian Proxy  │────▶│  Claude API  │
│  (your app)  │◀────│  (patched by     │◀────│  (Max Sub)   │
│              │     │   nyxclaw)       │     │              │
└─────────────┘     └──────────────────┘     └──────────────┘

1. OCPlatform sends API requests to Meridian (localhost)
2. Meridian proxies them to Claude using your Max subscription
3. nyxclaw's patch ensures passthrough mode doesn't limit tool use
4. MERIDIAN_PASSTHROUGH=1 enables the passthrough pipeline

systemd Service

The generated service file at /etc/systemd/system/meridian.service:

[Service]
User=meridian
Environment=MERIDIAN_PASSTHROUGH=1
Restart=always
RestartSec=5

Useful commands:

sudo systemctl start meridian      # Start
sudo systemctl stop meridian       # Stop
sudo systemctl restart meridian    # Restart
journalctl -u meridian -f          # Follow logs

After Meridian Updates

When you update meridian, the patch gets overwritten. Just re-apply:

npm update -g @rynfar/meridian
sudo nyxclaw patch
sudo systemctl restart meridian

Or if you installed nyxclaw globally, the postinstall script will try to auto-patch.

Requirements

• Node.js >= 18
• Linux (systemd-based)
• Root access (for setup)
• Claude Max subscription (logged in via claude login)

Troubleshooting

"maxTurns pattern not found" Meridian may have updated its source code. Check the dist file manually:

grep -r "maxTurns" $(npm prefix -g)/lib/node_modules/@rynfar/meridian/dist/

Service won't start

journalctl -u meridian -n 50 --no-pager

Claude not authenticated

sudo -u meridian claude login

License

MIT © Fabian Budde

Built by Nyx 🦞 — the cosmic lobster that patches your proxies.