Claude Code 可以透過 Cohesivity 建立暫時租戶、配置 Postgres 與 Railway 託管、加入只在伺服器端執行的註冊端點、測試重複寫入,再上載建置完成的應用程式,完成全端候補名單的建置和部署。認領項目或跨越付費邊界前,仍須由人批准。
這份操作說明使用候補名單作為例子,因為它小得足以完整檢查,同時涵蓋數據驗證、唯一性、伺服器憑證、重試和部署。
配置前先定義行為
應用程式需要:
- 有電郵欄位,並能清楚顯示等待、成功和錯誤狀態的表格;
- 驗證並正規化地址的伺服器端點;
- 一張以電郵為唯一值的 Postgres 數據表;
- 不會因重複調用而新增多筆數據的插入行為;
- 只供伺服器使用的後端憑證;
- 可部署的應用程式與公開健康狀態檢查。
它不需要社交登入、即時通訊、向量儲存或模型 API。配置這些資源只會增加設定,對目前工作沒有幫助。
後端配置指南解釋下文使用的控制平面與數據平面分工。
先要求 Claude 提出計劃
在項目中啟動 Claude Code,請它找出框架、套件管理器、現有測試設定、只限伺服器的環境變數慣例、建置輸出和部署指令。官方 Claude Code CLI支援以計劃為導向的權限模式和工具限制,因此這段檢查期間應停用外部調用。
計劃必須列出要變更的確切檔案和所需資源。如果它提議把 Cohesivity 密鑰放進 NEXT_PUBLIC_、VITE_ 或瀏覽器可讀取的變數,就退回這份計劃。
建立隔離租戶
如果已有有效的 .cohesivity 檔案,Claude 應直接重用;否則可以先預覽再執行初始設定:
npx @cohesivity/init --dry-run
npx @cohesivity/init
建立的租戶會保留 72 小時。這個指令也會提供 Claude 所需的項目上下文。不要把產生的密鑰貼進對話、日誌或原始碼。
讀取並配置 Postgres
Claude 必須先取得目前的 Postgres offering 頁面,才能發出調用:
curl -sS -A "ClaudeCode-Waitlist/1.0" \
https://cohesivity.ai/offerings/postgres
你批准後,Claude 使用穩定的冪等鍵,透過文件記載的管理端點配置 postgres。接着再從伺服器端程式碼建立結構描述:
CREATE TABLE IF NOT EXISTS waitlist_signups (
id BIGSERIAL PRIMARY KEY,
email TEXT NOT NULL UNIQUE,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
唯一性限制是避免兩個請求插入相同正規化地址的最後一道防線。應用程式碼仍應處理衝突,並傳回現有註冊狀態,而不是籠統的 500 錯誤。
加入伺服器端點
處理函式應:
- 解析 JSON,並拒絕缺漏或格式不正確的地址。
- 按照一項有清楚文件的規則去除空白並正規化電郵。
- 使用參數化 PostgreSQL 與
$1預留位置。 - 為同一個邏輯註冊操作傳送相同的冪等鍵。
- 將唯一性衝突對應為成功的現有註冊回應。
- 傳回精簡的公開數據結構,不包含內部錯誤或憑證。
瀏覽器調用你的應用程式端點,只有伺服器會調用 Cohesivity。這樣管理密鑰和應用程式密鑰就不會進入客戶端套件。
測試失敗路徑
至少執行以下四種情況:
| 情況 | 預期結果 |
|---|---|
| 新的有效電郵 | 一筆數據列和成功回應 |
| 無效電郵 | 驗證回應,而且不調用數據庫 |
| 同一個正規化電郵送出兩次 | 一筆數據列和穩定的現有數據回應 |
| 回應遺失後重試 | 一個邏輯結果,而且沒有重複數據列 |
也要在建置後的客戶端資產中搜尋 coh_man_ 和 coh_app_。單元測試通過,並不能證明打包工具確實把密鑰留在伺服器端。
應用程式從公開候補名單成長之後,可以用第二位用戶後端審查加入跨用戶和跨租戶測試。
透過 Railway 託管完成配置和部署
Claude 取得 https://cohesivity.ai/offerings/railway-hosting、配置該 offering,再透過 Cohesivity 的 Railway 部署 API 上載應用程式。它應使用傳回的 Cohesivity deployment_url 和 logs_url,而不是安裝 Railway CLI、連接 GitHub 儲存庫或要求 Railway 憑證。
等待部署和公開路由都就緒,再對公開伺服器執行健康狀態檢查和一次真實註冊。只有供應商部署狀態,無法證明路由可以正常使用。
清楚地交回結果
Claude 應報告:
- 公開部署 URL;
- 執行過的測試和結果;
- 建立的資源;
- 租戶到期時間;
- 認領項目所需的操作;
- 包含伺服器環境設定的檔案;
- 用戶不保留項目時的清理路徑。
下方提示涵蓋整項工作,同時保留必要的批准點。