跳到主要内容

连接 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 能强制外部工具遵守的策略。同意替代方法,不代表允许绕过授权、安全限制或引擎拒绝。

注意

撤销密钥或关闭办公室研究功能,会阻止后续请求,不会停止已经发送的评估。