问题背景

在使用 OpenCode 工具接入 OpenAI Codex 模型时，遇到了以下报错：

OpenAI codex passthrough requires a non-empty instructions field

这个错误表明 Codex 的 passthrough 模式强制要求提供非空的 instructions 字段，但 OpenCode 的配置中没有正确传递该参数。

---

环境信息

项目	版本/配置
工具	OpenCode CLI
模型	gpt-5.3-codex（第三方中转 API）
API 地址	https://api.iotwq.top/v1
配置文件	~/.config/opencode/config.json

---

问题复现

原始配置（报错）

{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.iotwq.top/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex",
          "limit": {
            "context": 400000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        }
      }
    }
  },
  "agent": {
    "build": { "options": { "store": false } },
    "plan": { "options": { "store": false } }
  }
}

报错原因：gpt-5.3-codex 模型的 options 中缺少 instructions 字段，Codex passthrough 模式拒绝执行。

---

解决方案

修复后的配置

在模型的 options 中添加 instructions 字段：

{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.iotwq.top/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex",
          "limit": {
            "context": 400000,
            "output": 128000
          },
          "options": {
            "store": false,
            "instructions": "你是一个专业的全栈开发助手，擅长 Vue3、uni-app、TypeScript 和 SCSS。请提供高质量、可维护的代码，遵循项目现有代码风格。"
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        }
      }
    }
  },
  "agent": {
    "build": { "options": { "store": false } },
    "plan": { "options": { "store": false } }
  }
}

---

总结

问题	原因	解决
requires a non-empty instructions field	Codex passthrough 模式缺少系统指令	在模型 options 中添加 instructions

核心要点：OpenCode 作为中间层，需要把 instructions 正确透传给 Codex API。只要确保配置中有非空的 instructions，该错误即可解决。

---

参考

• OpenCode 官方文档
• OpenAI Codex API 文档