Skip to main content
A “session” is the container for your conversations with Claude Code. Its concept is consistent with Claude Code’s Conversation History. Each project can contain multiple sessions, and the context of different sessions is isolated from one another, making it suitable for handling different tasks or topics within the same project without interference.

​
Session Overview

Each session contains:
  • Conversation history — Your conversations with Claude Code, tool calls/commands, and key output results, used to maintain context (for example, remembering error file paths, discussed approaches, and so on).
  • Project information — Project-related information remembered by Claude Code.
  • Tool call records — All tool calls/commands executed by Claude Code while completing tasks, along with their output results.
Session context affects Claude Code’s responses. If you want to start a completely new task from scratch, it is recommended to create a new session.

​
Create a Session

1

Make sure a project is selected

Select a project in the left sidebar
2

Click New

In the session list area, click the + New Session button
3

Start chatting

After the new session is created, you can start chatting with Claude Code in the chat box on the right
Create a new session

​
Switch Sessions

Click any session in the session list to switch to it. When switching sessions:
  • The current conversation content is automatically saved
  • The new session’s history is loaded and displayed
  • Claude Code’s context switches to the target session

​
Delete a Session

1

Find the session

Find the session you want to delete in the session list
2

Right-click or click the menu

Right-click the session or click the menu icon
3

Select Delete

Confirm the delete operation
Deleting a session permanently deletes all conversation history for that session. This operation cannot be undone.

​
Session Best Practices

​
When to Create a New Session

  • Start a new task — When you want to start a completely new task that is unrelated to previous ones
  • Context is too long — When the conversation becomes very long and response speed slows down
  • Start over — When Claude Code’s understanding has gone off track and you need to start over
  • Separate concerns — When you want to manage the development of different features or modules separately

​
When to Continue an Existing Session

  • Iterative development — Continuously iterating and improving on the same feature
  • Bug fixes — Fixing errors in code or other outputs previously produced by Claude Code
  • Feature expansion — Adding new features on top of an existing implementation
  • Context-related — When the new issue is closely related to previous conversations

​
Session Storage

Session data is stored in the cloud sandbox corresponding to the project and has the following characteristics:
FeatureDescription
Auto-saveConversation content is automatically saved in real time
Cross-device accessAccessible from any device after logging in with the same API Key
Project bindingSessions are associated with projects; deleting a project deletes all sessions
It is recommended to export important conversation content or copy it locally for safekeeping.

Project Management

Manage and organize your projects

Chat Mode

In Chat Mode, you can ask Claude Code to help you complete tasks through a chat interface.