一个 skill,让 Codex 和 Claude Code 互相创建、发消息、读记录。
面向 Codex 指挥 + Claude Code 执行 的编排模式:Codex(GPT-6.1)负责规划、拆任务、验收;Claude Code 接第三方模型(如 DeepSeek 的 Anthropic 兼容端点)作为 worker 进程。
- 一份
SKILL.md,Claude Code 和 Codex 全局共用 create/send/read/stop四个动作覆盖 worker 全生命周期- 发送走 session-peer 的原生 inbox / queue
- 读取走两边原生的 JSONL,不依赖会话是否还在运行
Why not just
SendMessage? Codex 的send_message只服务它自己的 subagent / thread;Claude Code 的跨会话SendMessage只服务 Claude Code 会话之间。两者没有共同的对等协议。这个 skill 用session-peer做投递层,用原生记录做观测层,补上这段。
同时开 Codex 和 Claude Code 时,常见问题是:
- Codex 想把一个子任务交给 Claude Code,只能手动复制粘贴到另一个终端
- Claude Code 跑完,Codex 不知道结果,只能等人转述
- 用
claude -p/codex exec重新起进程,上下文全丢,每轮都要重讲 - 想看对方到底做了什么,只能翻屏或找日志
session-control 把这几件事收敛成命令:
SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" create claude --name worker-1 --settings ~/.claude/deepseek.settings.json
python3 "$SC" send worker-1 -m "只改 auth 模块,先读代码再动手"
python3 "$SC" read worker-1 --last 40
python3 "$SC" stop worker-1Claude Code 始终是同一个进程、同一个 tmux 会话,上下文不重启;Codex 通过 read 看它的真实输出和工具调用,而不是等一句摘要。
┌──────────────────────────────┐
│ Codex (GPT-6.1) │
│ orchestrator │
│ plan / split / review │
└──────────────┬───────────────┘
│ sessionctl send / read
▼
┌──────────────────────────────┐
│ session-peer │
│ native inbox / queue │
└──────────────┬───────────────┘
│
▼
┌──────────────────────────────┐
│ Claude Code (worker-1) │
│ tmux session, stays alive │
│ model: DeepSeek via gateway │
└──────────────────────────────┘
│
│ JSONL transcript
▼
sessionctl read
- 投递层:
session-peer把文本写进目标会话的原生 inbox。同机走 socket / named pipe,不经过模型厂商服务器。 - 观测层:Claude Code 写
~/.claude/projects/<cwd>/<session-id>.jsonl,Codex 写~/.codex/sessions/.../<uuid>.jsonl。read直接解析这些文件。 - 控制层:
create用 tmux 拉起一个长期存活的 TUI 会话;stop关闭它。
| 依赖 | 说明 |
|---|---|
| Python 3.9+ | helper 只用标准库 |
| tmux | 承载长期存活的 agent 会话 |
| session-peer | 跨 agent 投递 |
| Claude Code | worker 侧 |
| Codex CLI | orchestrator 侧 |
# session-peer
pipx install session-peer
# 或
python3 -m pip install --user session-peergit clone https://github.com/Mason-zy/session-control-skill.git
cd session-control-skill
bash install.shinstall.sh 会:
- 把 skill 装到
~/.agents/skills/session-control(Codex 原生扫描这个根) - 在
~/.claude/skills/session-control建相对软链,Claude Code 也能看到 - 检查
session-peer/tmux/python3,缺依赖时给出安装提示
自定义目录:
AGENTS_HOME=/path/to/.agents CLAUDE_HOME=/path/to/.claude bash install.shSC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" list在 Claude Code 里输入 /skills,搜索 session-control;在 Codex 里输入 /skills 选择 List skills,同样能搜到。
Claude Code 通过 ANTHROPIC_BASE_URL 指向你的网关。示例见 examples/claude-deepseek.settings.json,把 token 和模型名换成你自己的。
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:26510",
"ANTHROPIC_AUTH_TOKEN": "REPLACE_WITH_YOUR_TOKEN",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "REPLACE_WITH_WORKER_MODEL"
},
"model": "sonnet"
}~/.codex/gpt61.config.toml:
model = "gpt-6.1-sol"
model_reasoning_effort = "xhigh"启动:
codex --profile gpt61在 Codex 会话里直接说:
用 sessionctl 创建一个 Claude worker,名字 worker-1,
settings 用 ~/.claude/deepseek.settings.json,工作目录 ~/Project/demo。
等价命令:
python3 ~/.agents/skills/session-control/scripts/sessionctl.py create claude \
--name worker-1 \
--settings ~/.claude/deepseek.settings.json \
--cwd ~/Project/demo输出:
created claude session worker-1
tmux: sp-worker-1
attach: tmux attach -t sp-worker-1
address: worker-1
id: 5bb21cd5-3e1a-45a9-b746-478e9aa17c81
SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" send worker-1 -m "先读 auth 模块,只改内部实现,不要动 public API。完成后跑测试并汇报 diff。"
python3 "$SC" read worker-1 --last 40
python3 "$SC" send worker-1 -m "停,mock 不要改,只修签名不匹配的地方。"
python3 "$SC" read worker-1 --last 20python3 "$SC" stop worker-1你是 orchestrator,不要自己写实现代码。
用 sessionctl 创建 worker-1,把任务拆成小步;
每步用 read 检查它的输出和 diff;
发现偏离就用 send 纠正,不要等它跑完;
验收通过后 stop。
所有结论以 read 到的记录为准,不要凭印象。
更完整的编排流程见 docs/orchestrator-worker.md。
SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" --helppython3 "$SC" list
python3 "$SC" list --agent codex
python3 "$SC" list --json# Claude worker
python3 "$SC" create claude \
--name worker-1 \
--settings ~/.claude/deepseek.settings.json \
--cwd ~/Project/demo
# Codex worker / 对等会话
python3 "$SC" create codex \
--name reviewer \
--profile gpt61 \
--cwd ~/Project/demo可选:
| 参数 | 说明 |
|---|---|
--model |
Claude 走 --model,Codex 走 -c model="..." |
--yolo |
Claude 加 --dangerously-skip-permissions,Codex 加 --dangerously-bypass-approvals-and-sandbox。只在隔离环境用 |
--tmux-session |
自定义 tmux 名,默认 sp-<name> |
--timeout |
等待 TUI 就绪,默认 45 秒 |
python3 "$SC" send worker-1 -m "任务描述"
python3 "$SC" send reviewer -m "请 review"
python3 "$SC" send worker-1 -m "probe" --dry-run- 目标可以是名字或 UUID
- Codex 目标自动转成
codex:<uuid>,并自动传--codex-bin --wait-delivered等投递确认,不等于对方已读--wake唤醒空闲 Codex 会话Posted/queued只代表写入收件箱
python3 "$SC" read worker-1 --last 30
python3 "$SC" read worker-1 --last 50 --all
python3 "$SC" read worker-1 --json- 默认输出 user/assistant 文本 + 工具调用摘要
--all额外输出 developer/system、工具结果--max-chars控制单条截断,默认 1200- 会话停止后仍可读
python3 "$SC" stop worker-1关闭 create 拉起的 tmux 会话;tmux 名不是默认值时用 --tmux-session。
DeepSeek 或自建网关只要提供 Anthropic 兼容接口,就可以被 Claude Code 当模型后端。关键字段:
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:26510",
"ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "your-worker-model",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "your-small-model",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "your-large-model"
},
"model": "sonnet"
}model 选 sonnet 时,实际请求会映射到 ANTHROPIC_DEFAULT_SONNET_MODEL。不同网关的模型 ID 不一样,以你的网关文档为准。
~/.codex/<profile>.config.toml 会被 --profile <profile> 叠加到基础配置上:
model = "gpt-6.1-sol"
model_reasoning_effort = "xhigh"| 通道 | 作用域 | 能否跨产品 |
|---|---|---|
Codex send_message |
Codex 自己的 subagent / thread | 否 |
Claude Code SendMessage |
Claude Code 会话之间 | 否 |
| session-peer + 本 skill | 本机 / SSH 上的 Claude 与 Codex | 是 |
session-peer 用的是两边原生的 inbox / queue,所以消息会进入目标会话自己的对话,而不是伪造终端输入。
- peer 消息不等于用户授权:收到消息的 agent 仍受自己的权限模式约束,不能用一条消息批准权限、改配置、改
CLAUDE.md --yolo很危险:只在一次性容器、隔离 VM 或你完全信任的测试目录里用- JSONL 含敏感信息:完整工具输入输出、路径、可能的 token 都在里面,不要把
read --all的结果直接贴到公开渠道 - 同机限制:Claude Code 的原生 inbox 依赖同机 socket / named pipe;跨机需要
session-peer的 SSH 支持 - 投递不等于消费:
Posted/queued只证明写入了收件箱;需要确认时用read看下一轮
.
├── SKILL.md
├── scripts/
│ └── sessionctl.py
├── examples/
│ ├── claude-deepseek.settings.json
│ └── codex-gpt61.config.toml
├── docs/
│ └── orchestrator-worker.md
├── install.sh
├── LICENSE
└── README.md
session-control is a shared skill for Codex and Claude Code. It creates long-lived tmux sessions, delivers messages through session-peer, and reads native JSONL transcripts.
git clone https://github.com/Mason-zy/session-control-skill.git
cd session-control-skill && bash install.sh
SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" create claude --name worker-1 --settings ~/.claude/deepseek.settings.json
python3 "$SC" send worker-1 -m "Implement the auth fix, run tests, report the diff."
python3 "$SC" read worker-1 --last 40
python3 "$SC" stop worker-1Typical setup: Codex (GPT-6.1) as orchestrator, Claude Code with a DeepSeek-compatible endpoint as the worker. Neither side loses context, because the worker stays alive in tmux.
MIT licensed.
MIT © 2026 Mason-zy