接進 Claude Code:API Key、Agent Skill 與 Jev 開關
先校正期待:Jev 是決策節點,不是 Claude 的替代品
「把 Jev 接進 Claude Code」聽起來像換一顆模型,但官方文件把定位講得很清楚1:
- Jev 不會取代 Claude Code 背後的 LLM,也不存在「把 agent 換成 Jev」的設定。
- Jev 的角色是:你的 agent(或應用程式)在工作流的判斷節點上呼叫的決策模型。
- 因此實作上,Jev 通常以三種形式出現:agent 幫你寫出的呼叫程式碼、包裝好的 skill/工具、或掛在 hook 上的自動判斷。
換句話說:Claude 負責「想和做」,Jev 負責「選」。
第 1 步:取得 API Key
到 TypeSafe Console 建立 API key,並存進環境變數(官方 quickstart 的建議作法)2:
export TYPESAFE_API_KEY="your-api-key"
計費僅按輸入 token 計算、輸出免費(jev-1.13.0 為 $42 / Btok)3;影片另提到註冊贈送 $5 額度、足以做大量實驗,實際方案以官方公告為準。不想走官方時,影片也提到可透過 OpenRouter 接入(第三方路徑,使用前請自行確認支援狀況)4。
第 2 步:安裝官方 Agent Skill
官方為 Claude Code、Codex 等 agent 準備了可直接安裝的 TypeSafe Agent Skill,讓 agent 具備 Jev API、三種題型與架構模式的完整 context,能替你生成正確的整合5:
# Claude Code
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
# 其他 agent(安裝時選擇你的 agent)
npx skills add typesafe-ai/skills --skill typesafe-ai
安裝後可以用 /typesafe:typesafe-ai 或「use the TypeSafe skill」明確叫用。之後請 agent 探索專案、找出適合改用 Jev 的判斷點,例如:
Using the TypeSafe skill, explore the project and find opportunities for using
intelligent judgement to stand in for complex parsing or other fragile code.
第 3 步:把 Jev 包成一個「開關」
影片作者建議的關鍵一步:不要讓 Jev 滲進每個角落,而是做成一個可開關的 skill 或指令4:
- 開啟時:當前對話中適合做判斷的任務,優先丟給 Jev 處理。
- 關閉時:Claude Code 回到原本的運作方式。
- 好處是隨時能做對照實驗——加裝 Jev 到底省了多少、品質有沒有打折,一目瞭然。
給 Claude 的提示詞可以照這個結構寫(改編自影片建議):
請讀 TypeSafe 官方文件,並使用以下的 Jev API key:
TYPESAFE_API_KEY=<你的 key>
幫我做一個 Jev 開關:
- 打開時,我每送一句 prompt,先讓 Jev 判斷這題該用哪個等級的模型、
該載入哪些 skill,再交給對應的模型執行。
- 關閉時,完全回到原本流程。
- 有需要釐清的地方請先詢問我,不要直接開始做。
- 完成後,用我最常用的幾個任務各跑一次「開/關」對照,
比較 token 用量與輸出品質。
這正是影片「三個位置」中位置一(挑模型、挑 skill)的具體實作,可搭配實戰範例 001逐步操作。
第 4 步:驗證,然後才全面開啟
官方 Agent Skill 文件裡的「good vibe coding principles」值得直接照抄5:
- 先和 agent 討論計畫,確認合理再實作。
- 把問題(questions)與門檻(thresholds)集中放在一處,方便審閱修改——agent 寫問題的功力普通,預期要協作編輯。
- 不要照單全收 agent 的假設,要求它驗證。
另外兩個常見坑6:
- 門檻調不好:太高會把該走的判斷都漏掉(false negative),太低則什麼都觸發(false positive)。遇到路由不如預期,先回頭檢查問題措辭與門檻。
- 中文情境要實測:Jev 以英文為主場,CJK 文字可以處理但準確度未等同英文3;建議先用你手上的真實資料(中文留言、中文程式註解)跑一批,觀察 confidence 與人工比對的落差再決定依賴程度。
小結
- 安裝順序:API key → Agent Skill → Jev 開關 → A/B 驗證。
- 心態:Jev 是工作流裡的判斷節點,不是換腦;開關機制讓你可以隨時退回原狀。
- 下一步:三個黃金位置:判斷外包地圖。