Actions9
- Task Actions
- Session Actions
- Admin Actions
Session → Start Session
AI-generatedSummary
Start a new persistent multi-turn session with Claude, optionally specifying the model and the working directory source for Claude's runtime context.
Inputs
- Model — The Claude model to use. Leave empty to use the server default.
- Working Directory — Specifies where Claude should run: the server default, a git repository (which will be cloned or pulled automatically), or a custom absolute path on the server.
- Repository URL (required) — Git repository URL to clone or pull if 'Git Repository' is chosen as the working directory source.
- Branch — The git branch to checkout. Leave empty to use the default branch.
- Path (required) — Absolute path on the Claudeway server where Claude should run when 'Custom Path' is chosen as the working directory source.
- Additional Fields — Optional additional parameters such as a system prompt to set Claude's behavior for the session.
Output shape
a JSON object containing session details as returned by the Claudeway API (e.g. session ID, metadata).
The output includes session metadata necessary for subsequent session operations such as continuing conversations or managing the session. The working directory input determines where Claude operates in the server environment.
Examples
Example 1: Create a new session executing in a git repository
Select 'Git Repository' as working directory, provide the repository URL and optionally the branch; select the desired model or leave empty for default; optionally add a system prompt.
Example 2: Create a session with default server settings
Leave 'Working Directory' as 'Default', leave Model empty to use server default. Optionally add a system prompt.