---
title: "exec 新建或 fork 时用 --thread-source 标注来源"
summary: "默认 user。CI、夜间任务、自动审查应写成自己的来源名。resume 不会改已经写进会话的来源。不是 originator。"
category: automation
level: intermediate
surfaces: [cli, ci]
tags: ["exec", "thread-source", "CI"]
canonical: /tips/exec-thread-source/
---

# exec 新建或 fork 时用 --thread-source 标注来源

默认 user。CI、夜间任务、自动审查应写成自己的来源名。resume 不会改已经写进会话的来源。不是 originator。

交互 TUI 开的线程默认来源是 `user`。无头任务也这样标，分析面板就分不清人还是流水线。新建或 fork 时显式写：

```bash
codex exec --thread-source automated_review \
  --sandbox workspace-write --ask-for-approval never \
  "对照 main 做审查，只输出风险。"

codex exec fork --last --thread-source nightly_ci \
  "继续修刚才失败的测试。"
```

TypeScript SDK 对应 `threadSource`。Python SDK 开线程时也可以带调用方来源。值会写进 rollout，并出现在 `x-codex-turn-metadata`。这和 originator 覆盖是两套字段，改其中一个不会改另一个。

`codex exec resume` 沿用磁盘上已保存的来源，再加 `--thread-source` 也改不了旧线程。要换标签就 fork 或新开。本机 `codex exec --help` 没有这个旗标就先升级 CLI，不要抄过时包装脚本。

## 来源

- [openai/codex#40155](https://github.com/openai/codex/pull/40155)