连接 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 能强制外部工具遵守的策略。同意替代方法,不代表允许绕过授权、安全限制或引擎拒绝。
撤销密钥或关闭办公室研究功能,会阻止后续请求,不会停止已经发送的评估。