← Workspaces for agents

Workspaces for Claude Code

Put Claude Code beside your running app.

Investigate a bug, edit the code, and test the fix in one development environment. Claude Code runs in your Wodby workspace while you work from your terminal or, when available, Claude Remote Control.

Create a workspaceConnect Claude Code

Connect Claude Code to your workspace

  1. 1. Create a supported dev workspace

    Choose workspace mode for a new environment with a compatible stack and Git source. Wait for setup to finish. You must be the workspace owner with current modify access, and have your public SSH key registered in Wodby.

  2. 2. Use the connection details from Wodby

    Copy the workspace’s SSH configuration into your computer’s SSH config and select your private key file. Use the displayed host, port, user, and checkout path, and verify the server fingerprint. Replace YOUR_WORKSPACE_ALIAS below with that configuration’s host alias.

    On your computer
    ssh YOUR_WORKSPACE_ALIAS

  3. 3. Start Claude Code in the checkout

    In the SSH session, replace /PATH/TO/CHECKOUT with the working directory shown in Wodby. SSH starts in your home directory, so change into the checkout before working on the app.

    In the workspace: Claude Code
    cd /PATH/TO/CHECKOUT && claude

    Sign in with your own Claude account when prompted. The supported workspace launcher downloads Claude Code on first use. Follow the connection panel’s tool availability guidance if your runner needs a restart. Official authentication guidance.

Continue from the browser or your phone

For optional Remote Control, sign in through claude.ai and start claude remote-control from the checkout inside a tmux session. Open the session URL in your browser or Claude mobile app. Execution stays in the workspace.

Remote Control needs an eligible Claude subscription and any required organization approval; API-key authentication is not supported for it. Keep the workspace and the Claude process running. tmux can survive an SSH disconnect, but pausing or restarting the workspace interrupts the process.

Official Claude Remote Control guide

Reproduce a bug and verify the fix

Give Claude Code a reproducible symptom and the expected result. Ask it to trace the issue through the code, make a focused fix, and run tests. Use the workspace preview to check the behavior yourself before releasing.

Example task for Claude Code
Investigate the bug I describe in this checkout. Explain the cause, make a focused fix, and run the relevant tests. Tell me how to verify the result in the running app. Ask before committing or pushing.

App services use the workspace checkout. Some services reload code automatically; others need a restart. Coordinate agents working on the same files and review changes before committing and pushing.

Keep your review and release workflow.

Commit and push the changes you accept, then use CI/CD to release them to a standard staging or production environment. Workspaces give your agent a place to develop and preview.

Explore CI/CDWorkspaces for Codex