Claude Code

Copy Markdown View Source

You can connect Tidewave Web directly to Claude Code.

Simply open up Tidewave Web settings, choose the Providers tab, choose "Claude Code" and click "Connect". Next we will automatically download and install Claude for you.

Once connected, we will automatically configure Claude to also use Tidewave MCP. You may disable this option if (and only if) you have already customized Claude Code to use Tidewave MCP.

Custom claude-agent-acp installation

Tidewave talks to Claude Code using the Claude Agent ACP project. It is possible to use a custom claude-agent-acp executable by setting the TIDEWAVE_CLAUDE_AGENT_ACP_EXECUTABLE environment variable, either in your running web application, or in the Tidewave App/CLI. This is rarely needed in practice but it may be required in some operating systems like NixOS.

Customizing your environment

Our integration will reuse your Claude Code settings. Furthermore, Tidewave will automatically pass your environment variables to Claude Code, using this level of priority:

  1. the environment variables used when starting your web app (higher priority)
  2. the environment variables configured in your Tidewave App (or given to the Tidewave CLI)

To configure the Tidewave app to use Claude Code's environment variables, click on the Tidewave icon in your menu bar (top-right on macOS and Linux, bottom-right on Windows) and then on "Settings...". Doing so will open a file where you can add the desired environment variables, for example:

# This file is used to configure the Tidewave app.
# If you change this file, you must restart Tidewave.

[env]
CLAUDE_CODE_USE_VERTEX = "1"
CLAUDE_CODE_EXECUTABLE = "..."

If you are using the CLI, you can set those variables when starting the CLI.

MAX_THINKING_TOKENS configuration

The MAX_THINKING_TOKENS configuration, exclusively, cannot be set in the Tidewave App/CLI environment. You must set it in the same session that as your running app. This is because Tidewave sets a default of 31999 tokens (which is the same as Claude Code itself).

FAQ

Using Tidewave Web with Claude Code emits "Authentication required"

This means you haven't authenticated in the claude CLI. Go to "Settings", click "Providers", and then "Claude Code". If you are connected to Claude Code, you should see a "Open Terminal" option. Open up the terminal and type /login to authenticate. Alternatively, you can claude in your terminal of choice.

If Tidewave Web still claims you are not authenticated, restart the Tidewave App/CLI by clicking its menu bar icon (top-right on macOS and Linux, bottom-right on Windows) and selecting "Restart".