# CLAUDE_CODE_TASK_LIST_ID

> Give sessions the same id, and they share one task list.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** CLAUDE_CODE_TASK_LIST_ID=release

## Think of it like

It is like two cooks who read from the same order board.

## Definition

CLAUDE_CODE_TASK_LIST_ID lets several Claude Code sessions share one task list. Give each session the same id, and they all see and update the same tasks. It works in sessions that have the task tools.

## Example

Emma runs one session on the API and one on the website. With the same id, each sees what the other has done.

## Example code

```bash
CLAUDE_CODE_TASK_LIST_ID=release claude
# in a second terminal
CLAUDE_CODE_TASK_LIST_ID=release claude
```

Two sessions, one task list.

## Why it matters

Without a shared list, two sessions can do the same job twice or miss one.

## Common mistake

Giving the sessions different ids and expecting them to share. The id must match.

## Three principles

- **Same id.** Same list.
- **Many sessions.** One board.
- **Needs task tools.** In the session.

## Related terms

- [Task Tools](https://learn.benibix.com/term/ai/task-tools)
- [/tasks Command](https://learn.benibix.com/term/ai/tasks-command)
- [Background Session](https://learn.benibix.com/term/ai/background-session)

---

Source: https://learn.benibix.com/term/ai/claude-code-task-list-id-variable
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
