Why does Claude Code exit with code 1 in my NanoClaw container?

This is typically caused by missing authentication (API keys or OAuth tokens), running as the root user instead of the 'node' user, or missing the --dangerously-skip-permissions flag.

How can I enable verbose debug logging?

Set the environment variable LOG_LEVEL=debug before starting the application to see full mount configurations and real-time container stderr.

How does the container communicate with messaging apps?

It uses an IPC system located in /workspace/ipc/ where the agent writes JSON files for outgoing messages and the host provides snapshots of scheduled tasks.

Where are the container logs located?

Individual container run logs, including stderr and stdout, are stored in the groups/{folder}/logs/ directory on the host machine.

How do I fix session resumption issues?

Ensure the container mount path is set to /home/node/.claude/ rather than /root/.claude/. The Claude SDK looks for session history in the home directory of the active user.

NanoClaw Container Debugger

Name: NanoClaw Container Debugger
Author: qwibitai

byqwibitai

•

25,589

•

Deployment & DevOps

Diagnoses and resolves execution issues within containerized agent environments, focusing on logs, mounts, and authentication.

The NanoClaw Container Debugging skill provides a comprehensive toolkit for troubleshooting isolated agent environments. It offers structured guidance on inspecting host and container logs, verifying volume mounts, managing environment variables, and resolving common authentication or permission errors. By standardizing the debugging process for containerized Claude Code instances, it ensures reliable session resumption and secure Inter-Process Communication (IPC) across messaging platforms like WhatsApp, Telegram, and Discord.

Key Features

01Manual container testing procedures and quick diagnostic shell scripts

02Verification of volume mounts and file system permissions for the 'node' user

0325,589 GitHub stars

04Standardized log mapping for host-side and container-side diagnostics

05Detailed IPC monitoring for messaging integrations and scheduled tasks

06Step-by-step resolution for Claude Code authentication and exit code 1 errors

Use Cases

01Verifying session persistence and isolation across different messaging groups

02Debugging environment variable injection and volume mount configurations

03Troubleshooting 'Claude Code process exited with code 1' and authentication failures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add qwibitai/nanoclaw debug

For use in Claude.ai and ChatGPT

Download Skill