Claude Code 任务列表

课程导读

这节课主要讲 Claude Code 的任务列表功能。复杂任务不要只靠一段长提示词硬推，先让 Claude Code 拆分任务，再按任务逐步执行，会更清楚，也更容易跟踪进度。

一、本节案例：OCR 图片识别网站

本节课使用智谱的 OCR 服务作为演示。

智谱 OCR 服务文档

二、课前准备

准备项	说明
Chrome 浏览器	用来测试生成的本地网站
智谱 API Key	调用 OCR 接口需要身份凭证
Claude Code	用来生成项目、读取文档、调试问题

API Key 可以看作访问接口的身份凭证。

真实项目里，不建议把 API Key 直接写进代码文件，更常见的方式是放到 .env 这类配置文件中，再由程序读取。

注意

不要把真实 API Key 上传到公开代码仓库，也不要发到公开群聊或公开文档里。

三、显示任务列表

当 Claude Code 创建任务列表后，任务会出现在终端的状态区域。

如果没有看到任务列表，可以使用快捷键切换显示：

快捷键	作用
Ctrl + T	显示或隐藏任务列表

任务列表通常会展示当前任务进度，例如哪些任务还没开始、哪些正在执行、哪些已经完成。

四、任务状态怎么看

任务前面的状态标记，用来表示任务当前处于什么阶段。

状态	含义
空白	任务还没开始
进行中	当前正在执行这个任务
已完成	任务已经完成
blocked by	当前任务被其他任务阻塞，需要先完成依赖任务

blocked by 6 and 7 的意思是：这个任务需要等编号 6 和编号 7 的任务完成之后，才能继续执行。

例如“安装依赖并验证运行”通常要等页面功能和接口功能开发完成后，才能真正测试。

五、查看或清理任务

除了用 Ctrl + T 展开任务列表，也可以直接问 Claude Code。

需求	可以这样问
查看全部任务	show me all tasks或者查看全部任务
清空全部任务	clear all tasks或者清空全部任务

任务较多时，终端区域可能只显示一部分。想看完整任务列表时，直接让 Claude Code 展示即可。

六、只共享任务列表，不恢复旧上下文

有时候我们只想保留任务列表，不想把旧会话里的长上下文也带回来。

这时可以使用 CLAUDE_CODE_TASK_LIST_ID。

1. 打开任务目录

系统	操作方式
macOS	打开访达，在顶部菜单栏选择“前往 → 前往文件夹”，或者按 Shift + Command + G，输入 ~/.claude/tasks/ 后回车
Windows	打开文件资源管理器，在地址栏输入 %USERPROFILE%\.claude\tasks\ 后回车

进入目录后，你会看到一个或多个任务文件夹。

可以打开文件夹查看里面的任务内容，根据任务描述判断哪一个是你要继续执行的任务组。

文件夹名称就是任务列表 ID。复制这个文件夹名称，后面启动 Claude Code 时会用到。

2. 使用任务列表 ID 启动 Claude Code

macOS / Linux

CLAUDE_CODE_TASK_LIST_ID=4f1b1b1c-56dc-478a-819f-2abe5fa24427 claude

Windows PowerShell

$env:CLAUDE_CODE_TASK_LIST_ID="4f1b1b1c-56dc-478a-819f-2abe5fa24427"; claude

启动后按 Ctrl + T，就可以查看这份任务列表。

这种方式适合在新会话里继续推进任务，同时避免把上一轮很长的上下文全部带回来。