Claude Code

Give Claude Code the ability to create cloud sandboxes, run code, deploy applications, register domains, and expose services to the internet.

Setup

Option A: One-Line Setup

If you haven't installed Conway yet, the setup script handles everything -- installs the terminal, creates a wallet, provisions an API key, and configures Claude Code automatically:

curl -fsSL https://conway.tech/terminal.sh | sh

The setup script detects Claude Code and writes the MCP configuration for you.

Option B: Manual Setup

If you already have an API key from app.conway.tech, add Conway as an MCP server:

claude mcp add conway conway-terminal -e CONWAY_API_KEY=cnwy_k_...

Or if you installed via npx:

claude mcp add conway npx conway-terminal -e CONWAY_API_KEY=cnwy_k_...

Your API key is in ~/.conway/config.json after running the setup script.

Verify Integration

Ask Claude Code to list your sandboxes:

> list my cloud sandboxes

Claude Code should use the sandbox_list tool and show your sandboxes.

Example Workflows

Deploy and Test

> create a sandbox, clone my repo, install deps, and run the tests

Build and Ship

> create a sandbox, set up a Node.js app, expose port 3000, and register a domain for it

Interactive Debugging

> start a Python REPL in my sandbox and help me debug this function

Full Stack

> spin up a sandbox with 4 vCPUs, install PostgreSQL and Redis, deploy my app, and give me a public URL

Tips

• Claude Code has direct terminal access, so it can chain sandbox commands naturally
• Use PTY sessions for interactive work like REPLs and editors
• Ask Claude Code to expose ports and register domains in the same conversation
• Conway tools work alongside Claude Code's built-in file editing and git tools

Troubleshooting

MCP Not Appearing

1. Check that Conway is registered: claude mcp list
2. Verify conway-terminal is installed: which conway-terminal
3. Check the API key is set correctly

Connection Issues

• Verify the API key is valid (~/.conway/config.json)
• Test connectivity: curl https://api.conway.tech/health
• Try a different region when creating sandboxes