---
title: "对接 app-server 先生成本机版本的 schema"
summary: "generate-ts / generate-json-schema 跟当前 CLI 版本绑定。升级 Codex 要重新生成，不要混用旧类型。"
category: automation
level: advanced
surfaces: [cli]
tags: ["app-server", "schema", "SDK"]
canonical: /tips/app-server-generate-schema/
---

# 对接 app-server 先生成本机版本的 schema

generate-ts / generate-json-schema 跟当前 CLI 版本绑定。升级 Codex 要重新生成，不要混用旧类型。

```bash
codex app-server generate-ts --out ./schemas
codex app-server generate-json-schema --out ./schemas
```

产物只对你跑这条命令时的 Codex 版本有效。客户端升级后重新生成，再对照 `thread/start`、`turn/start`。CI 自动化用 SDK，不要拿 app-server 当作业入口。

实验字段加 `--experimental`。WebSocket `--listen ws://` 默认未鉴权，只给 localhost 或 SSH 转发。

## 来源

- [OpenAI · Codex App Server](https://learn.chatgpt.com/docs/app-server)