連接 Codex 或 Claude Code
你可以把自己的 Codex 或 Claude Code 連到辦公室的研究工作區,直接參與研究,不需要主體或化身。MCP 是讓工具使用外部功能的連線方式;這裡只開放研究功能。
備妥帳號與金鑰
先安裝 Codex 並登入自己的 OpenAI 帳號,或安裝 Claude Code 並登入自己的 Anthropic 帳號。辦公室的研究功能與工作區須已開啟,你也需要它的有效研究金鑰。執行工具的電腦必須能連到 連接工具 提供的 HTTPS 位址。
- 打開 Edgewright,選 連接工具。
- 在 你的工具 選 Codex 或 Claude Code。
抽屜會顯示環境變數指令與工具設定。若提示公開位址未設定或不正確,請找負責維運的人修正;顯示設定本身不代表已連線。
把金鑰交給工具
把金鑰放在啟動工具的終端機裡,設定檔只引用變數名稱,不保存金鑰內容。
-
在 設定金鑰 選 複製指令,於 Bash 或 Zsh 執行:
read -rs SOULHALL_RESEARCH_KEY && export SOULHALL_RESEARCH_KEY -
貼上研究金鑰,按 Enter。貼上時不會顯示內容,也不會把金鑰寫進 shell 歷史紀錄。
-
選 直接查看設定,再選 複製設定。
- Codex:加入
~/.codex/config.toml,或你信任的專案裡的.codex/config.toml。 - Claude Code:存成專案根目錄的
.mcp.json。使用時依提示核准專案的伺服器。
- Codex:加入
-
儲存設定後,從剛才設定金鑰的同一個終端機啟動或重新啟動工具。
完成後,工具有了連線位址和讀取金鑰的方法。接著在工具裡驗證,不能只看抽屜已走到下一步。
不要把金鑰內容放進設定檔、命令列或對話。終端機關閉後,這次設定的環境變數不再保留;下次啟動前要重新設定。
確認連線可用
- 在 Codex 輸入
/mcp;Claude Code 可輸入/mcp,或在終端機執行claude mcp list。 - 查看
edgewright的狀態,確認已連線且工具已載入,而不是只看到名稱。 - 請工具列出研究工作區的資料集,先做一次唯讀查詢,再開始修改或評估。
成功載入工具且查詢得到回覆,才知道連線可用。
| 看到的狀況 | 下一步 |
|---|---|
| 已連線且工具已載入 | 可以開始研究。 |
只列出 edgewright 名稱 | 只確認設定存在,繼續查連線狀態。 |
| 等待核准 | 先核准伺服器,再確認。 |
| 連線失敗或需要驗證 | 核對環境變數、位址與金鑰狀態。 |
載入工具不是回測完成。評估是否成功,要讀取該次操作與評估的結果;金鑰的 最近使用 也不能替代這個檢查。
確認範圍與費用
一把金鑰只開放一間辦公室的研究工作區,而且能讀寫:上傳資料、撰寫策略、執行評估與讀取結果。它和同事、化身共用同一個工作區,不是你的私人副本。
金鑰不開放辦公室的對話、記憶、瀏覽器或報告,也不會讓你的工具變成化身或取得主體知識。
你的工具費用由自己的模型帳號負擔,Soulhall 不替你支付。它執行的研究不計入辦公室的模型輪次預算,這裡也沒有另外的研究配額或研究用量帳單。
安全地進行研究
- 把金鑰當成密碼保護。可能外洩時,到 Edgewright 立即 撤銷。
- 先約定共用工作區裡可以修改的資料與策略,遵守資料來源的使用權限。
- 要求工具正式評估時先用 Edgewright;做不到時先說明,取得你對具體替代方法的同意,並把結果標成「非 Edgewright 產出」。
這是給工具的研究指示,不是 Soulhall 能強制外部工具遵守的政策。同意替代方法,也不代表可以繞過授權、安全限制或引擎拒絕。
撤銷金鑰或關閉辦公室研究功能,會阻止後續請求,但不會停止已送出的評估。