跳至主要内容

連接 Codex 或 Claude Code

你可以把自己的 Codex 或 Claude Code 連到辦公室的研究工作區,直接參與研究,不需要主體或化身。MCP 是讓工具使用外部功能的連線方式;這裡只開放研究功能。

備妥帳號與金鑰​

開始之前

先安裝 Codex 並登入自己的 OpenAI 帳號,或安裝 Claude Code 並登入自己的 Anthropic 帳號。辦公室的研究功能與工作區須已開啟,你也需要它的有效研究金鑰。執行工具的電腦必須能連到 連接工具 提供的 HTTPS 位址。

  1. 打開 Edgewright,選 連接工具。
  2. 在 你的工具 選 Codex 或 Claude Code。

抽屜會顯示環境變數指令與工具設定。若提示公開位址未設定或不正確,請找負責維運的人修正;顯示設定本身不代表已連線。

把金鑰交給工具​

把金鑰放在啟動工具的終端機裡,設定檔只引用變數名稱,不保存金鑰內容。

  1. 在 設定金鑰 選 複製指令,於 Bash 或 Zsh 執行:

    read -rs SOULHALL_RESEARCH_KEY && export SOULHALL_RESEARCH_KEY
  2. 貼上研究金鑰,按 Enter。貼上時不會顯示內容,也不會把金鑰寫進 shell 歷史紀錄。

  3. 選 直接查看設定,再選 複製設定。

    • Codex:加入 ~/.codex/config.toml,或你信任的專案裡的 .codex/config.toml。
    • Claude Code:存成專案根目錄的 .mcp.json。使用時依提示核准專案的伺服器。
  4. 儲存設定後,從剛才設定金鑰的同一個終端機啟動或重新啟動工具。

完成後,工具有了連線位址和讀取金鑰的方法。接著在工具裡驗證,不能只看抽屜已走到下一步。

注意

不要把金鑰內容放進設定檔、命令列或對話。終端機關閉後,這次設定的環境變數不再保留;下次啟動前要重新設定。

確認連線可用​

  1. 在 Codex 輸入 /mcp;Claude Code 可輸入 /mcp,或在終端機執行 claude mcp list。
  2. 查看 edgewright 的狀態,確認已連線且工具已載入,而不是只看到名稱。
  3. 請工具列出研究工作區的資料集,先做一次唯讀查詢,再開始修改或評估。

成功載入工具且查詢得到回覆,才知道連線可用。

看到的狀況下一步
已連線且工具已載入可以開始研究。
只列出 edgewright 名稱只確認設定存在,繼續查連線狀態。
等待核准先核准伺服器,再確認。
連線失敗或需要驗證核對環境變數、位址與金鑰狀態。
備註

載入工具不是回測完成。評估是否成功,要讀取該次操作與評估的結果;金鑰的 最近使用 也不能替代這個檢查。

確認範圍與費用​

一把金鑰只開放一間辦公室的研究工作區,而且能讀寫:上傳資料、撰寫策略、執行評估與讀取結果。它和同事、化身共用同一個工作區,不是你的私人副本。

金鑰不開放辦公室的對話、記憶、瀏覽器或報告,也不會讓你的工具變成化身或取得主體知識。

你的工具費用由自己的模型帳號負擔,Soulhall 不替你支付。它執行的研究不計入辦公室的模型輪次預算,這裡也沒有另外的研究配額或研究用量帳單。

安全地進行研究​

  1. 把金鑰當成密碼保護。可能外洩時,到 Edgewright 立即 撤銷。
  2. 先約定共用工作區裡可以修改的資料與策略,遵守資料來源的使用權限。
  3. 要求工具正式評估時先用 Edgewright;做不到時先說明,取得你對具體替代方法的同意,並把結果標成「非 Edgewright 產出」。

這是給工具的研究指示,不是 Soulhall 能強制外部工具遵守的政策。同意替代方法,也不代表可以繞過授權、安全限制或引擎拒絕。

注意

撤銷金鑰或關閉辦公室研究功能,會阻止後續請求,但不會停止已送出的評估。