Codex Plugin

Hashee Codex Plugin（@hasheeai/codex-plugin）將 OpenAI Codex 連接到 Hashee 對話。它使用 Codex Hook 系統（stdin/stdout JSON 路由）透過 Agent SDK 在 Codex 工作階段和 Hashee 使用者之間轉發訊息。

運作方式

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → 連接 Hashee，同步對話
                            ├── prompt-submit   → 將使用者提示轉發至 Hashee
                            ├── pre-tool-use    → 從 Hashee App 中繼權限
                            └── stop            → 斷開並清理

此外掛作為 Codex Hook 二進位檔調用。它從 stdin 讀取 JSON 事件，分派到對應的處理函式，並將 JSON 結果寫入 stdout。

Hook 事件

事件	觸發時機	Hashee 動作
`session-start`	Codex 工作階段開始	連接 Agent SDK，同步活躍對話
`prompt-submit`	使用者提交提示	轉發到活躍的 Hashee 對話
`pre-tool-use`	Codex 請求工具執行	將權限請求中繼到 Hashee App
`stop`	Codex 工作階段結束	斷開 Agent SDK，清理

設定

1. 安裝

將外掛加入你的專案：

npm install @hasheeai/codex-plugin

2. 配置環境

export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # 可選，這是預設值

變數	必填	預設值	說明
`HASHEE_AGENT_ID`	是	—	Agent UUID
`HASHEE_AGENT_TOKEN`	是	—	Agent 驗證 Token
`HASHEE_SERVER_URL`	否	`https://api.hashee.ai`	API 基本 URL

3. 註冊為 Codex Hook

將外掛二進位檔加入你的 Codex Hook 配置：

npx tsx packages/public/codex-plugin/src/index.ts

或如果已全域安裝：

hashee-codex-plugin

權限中繼

當 Codex 請求權限執行工具（例如檔案寫入、Shell 命令）時，外掛將請求以 Artifact 的形式轉發到 Hashee App。使用者在 Hashee 對話中批准或拒絕，決定被中繼回 Codex。

加密

所有加密由 @hasheeai/agent-sdk-ts 處理。外掛傳送明文給 SDK，SDK 在傳輸前加密。入站訊息以加密形式到達，由 SDK 在外掛處理前解密。

下一步

Claude Code Plugin — Claude Code（MCP）整合
OpenClaw Plugin — OpenClaw 整合
SDK 入門 — 構建獨立的 Agent