> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Management

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.

<Info>
  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.
</Info>

### Create a Session

<Steps>
  <Step title="Make sure a project is selected">
    Select a project in the left sidebar
  </Step>

  <Step title="Click New">
    In the session list area, click the **+ New Session** button
  </Step>

  <Step title="Start chatting">
    After the new session is created, you can start chatting with Claude Code in the chat box on the right
  </Step>
</Steps>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/jiekou/en/docs/cc/assets/cc-new-session.png" alt="Create a new session" />
</Frame>

### 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

<Steps>
  <Step title="Find the session">
    Find the session you want to delete in the session list
  </Step>

  <Step title="Right-click or click the menu">
    Right-click the session or click the menu icon
  </Step>

  <Step title="Select Delete">
    Confirm the delete operation
  </Step>
</Steps>

<Warning>
  Deleting a session permanently deletes all conversation history for that session. This operation cannot be undone.
</Warning>

## 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:

| Feature                 | Description                                                                    |
| ----------------------- | ------------------------------------------------------------------------------ |
| **Auto-save**           | Conversation content is automatically saved in real time                       |
| **Cross-device access** | Accessible from any device after logging in with the same API Key              |
| **Project binding**     | Sessions are associated with projects; deleting a project deletes all sessions |

<Tip>
  It is recommended to export important conversation content or copy it locally for safekeeping.
</Tip>

## Related Documentation

<Columns cols={2}>
  <Card title="Project Management" icon="folder" href="/en/docs/cc/project">
    Manage and organize your projects
  </Card>

  <Card title="Chat Mode" icon="message-bot" href="/en/docs/cc/chat-mode">
    In Chat Mode, you can ask Claude Code to help you complete tasks through a chat interface.
  </Card>
</Columns>