網誌
代理原生後端

發佈日期 更新日期

Arag 及 Anshu

使用 Claude Code 與 Cohesivity 建置全端應用程式:完整操作說明

以 Markdown 閱讀

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 錯誤。

加入伺服器端點

處理函式應:

  1. 解析 JSON,並拒絕缺漏或格式不正確的地址。
  2. 按照一項有清楚文件的規則去除空白並正規化電郵。
  3. 使用參數化 PostgreSQL 與 $1 預留位置。
  4. 為同一個邏輯註冊操作傳送相同的冪等鍵。
  5. 將唯一性衝突對應為成功的現有註冊回應。
  6. 傳回精簡的公開數據結構,不包含內部錯誤或憑證。

瀏覽器調用你的應用程式端點,只有伺服器會調用 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;
  • 執行過的測試和結果;
  • 建立的資源;
  • 租戶到期時間;
  • 認領項目所需的操作;
  • 包含伺服器環境設定的檔案;
  • 用戶不保留項目時的清理路徑。

下方提示涵蓋整項工作,同時保留必要的批准點。