Agent 接入文档

Codex

Desktop / CLI 可配置

Codex Desktop、CLI 与 IDE 可使用同一套 Skill 和 MCP 配置。

开始之前

连接由 Skill、MCP 和 OAuth 组成

Skill 告诉 Codex 何时以及怎样使用 Attention；MCP 提供可调用的业务工具；OAuth 在浏览器中把连接授权给你的 Attention 账号。账号权益和 OAuth scope 会共同决定实际可见的工具子集。

CodexAttention SkillAttention MCP

步骤 1

加载统一的 Attention Skill

所有宿主使用同一份 Attention Skill。先查看统一 Skill 文档，再按本页给出的宿主命令或图形界面步骤导入。

查看 Attention Skill 文档

本页只说明 Codex 的加载方式。Skill 内容、版本和验收规则不因宿主变化。

下载后保存到macOS / Linux~/.agents/skills/attention/SKILL.mdWindows%USERPROFILE%\.agents\skills\attention\SKILL.md

步骤 2

添加 MCP 并完成 OAuth

添加 MCP 后，宿主会打开 Attention 的授权页面。请在浏览器中登录并确认授权；不要把 OAuth token 复制回 Agent。若宿主不支持浏览器 OAuth，才使用设置页中的 API Key 作为备用方案。

MCP 地址https://attention-staging.noveltystudio.cn/mcp

能力目录16 个业务工具 · 实际能力随授权和账号权益变化

查看机器清单

宿主命令

在本机运行；不会执行远端脚本

下载并校验 Skill（macOS / Linux） · macOS / Linux

(
  set -eu
  attention_skill_url=https://attention-staging.noveltystudio.cn/skills/attention/SKILL.md
  attention_skill_target="$HOME/.agents/skills/attention/SKILL.md"
  attention_skill_sha256=3ee54b3bff69751682a6537658314280641e831456e771c6f571b824afaedb6d
  attention_skill_dir=$(dirname "$attention_skill_target")
  mkdir -p "$attention_skill_dir"
  attention_skill_tmp=$(mktemp "$attention_skill_dir/.SKILL.md.XXXXXX")
  trap 'rm -f "$attention_skill_tmp"' EXIT HUP INT TERM
  curl --fail --show-error --silent --location --output "$attention_skill_tmp" -- "$attention_skill_url"
  if command -v sha256sum >/dev/null 2>&1; then
    attention_skill_actual=$(sha256sum "$attention_skill_tmp" | awk '{print $1}')
  else
    attention_skill_actual=$(shasum -a 256 "$attention_skill_tmp" | awk '{print $1}')
  fi
  [ "$attention_skill_actual" = "$attention_skill_sha256" ]
  chmod 0644 "$attention_skill_tmp"
  mv -f "$attention_skill_tmp" "$attention_skill_target"
  trap - EXIT HUP INT TERM
)

下载并校验 Skill（Windows PowerShell） · Windows

$ErrorActionPreference = 'Stop'
$attentionSkillUrl = 'https://attention-staging.noveltystudio.cn/skills/attention/SKILL.md'
$attentionSkillTarget = [Environment]::ExpandEnvironmentVariables('%USERPROFILE%\.agents\skills\attention\SKILL.md')
$attentionSkillSha256 = '3ee54b3bff69751682a6537658314280641e831456e771c6f571b824afaedb6d'
$attentionSkillDirectory = Split-Path -Parent $attentionSkillTarget
New-Item -ItemType Directory -Force -Path $attentionSkillDirectory | Out-Null
$attentionSkillTemp = Join-Path $attentionSkillDirectory ('.SKILL.md.' + [Guid]::NewGuid().ToString('N') + '.tmp')
try {
  Invoke-WebRequest -UseBasicParsing -Uri $attentionSkillUrl -OutFile $attentionSkillTemp
  $attentionSkillActual = (Get-FileHash -Algorithm SHA256 -LiteralPath $attentionSkillTemp).Hash.ToLowerInvariant()
  if ($attentionSkillActual -ne $attentionSkillSha256) { throw "Attention Skill SHA-256 mismatch" }
  Move-Item -Force -LiteralPath $attentionSkillTemp -Destination $attentionSkillTarget
} finally {
  if (Test-Path -LiteralPath $attentionSkillTemp) { Remove-Item -Force -LiteralPath $attentionSkillTemp }
}

添加 MCPcodex mcp add attention --url https://attention-staging.noveltystudio.cn/mcp

登录授权codex mcp login attention

查看 MCP 配置codex mcp get attention --json仅查看本地配置不代表工具已经可用。

步骤 3

微信接入

本机运行的 attention-channel 桥代替 Attention 接收微信消息，并以受限配置调用 Codex（仅 Attention MCP，禁用 shell、代码执行、文件写入和其他 MCP）。iLink 凭据只保存在你的设备上；可选 Runtime Reporter 只向 Attention 上报隐私安全的运行状态与配对结果，不上传消息、链接或凭据。此设置页不会仅凭配置推断连接状态。

启动本机桥attention channel start codex --origin https://attention-staging.noveltystudio.cn --background

手机微信 iOS ≥ 8.0.70 或 Android ≥ 8.0.69，并已启用 ClawBot（龙虾）插件
已完成 attention configure codex --apply --login（Skill、MCP、OAuth）
本机已安装 codex CLI

首次启动会显示二维码，用手机微信扫码一次即可；凭据只保存在本机，Attention 不显示也不验证微信连接状态。

步骤 4

用真实工具调用验收

在 Agent 中调用attention_get_my_account

在 Codex 中要求 Agent 调用 attention_get_my_account；只有成功返回当前 Attention 账号信息，才表示 Skill、MCP 与 OAuth均已可用。查看本地配置不算验收。