For AI agents

This page has a tab for each client, and they are all in this HTML, so reading it as text mixes every client's steps together. Read the Markdown instead: https://ifact.net/install.md (fetching this same address with Accept: text/markdown gives it too), or https://ifact.net/install.md?client=<id> for just your client's section. If you can't fetch it: Claude Code, Codex and WorkBuddy on macOS or Linux, run curl -fsSL https://ifact.net/setup.sh | sh. It never asks a question; the person approves once in the browser.

IFACT · 安装

把你的 agent 请进画布

一行命令,或者一个地址。主流的 agent 都能接进来,它做的每一张画板、每一次修改,都会实时出现在你的画布上。

让 agent 帮你装:把这句话发给它。

请打开 https://ifact.net/install,照上面的步骤给你自己装上 ifact。

Claude Code

一行命令接好,浏览器里点一次允许。

  1. 01

    在终端里运行这一行

    macOS 和 Linux 都可以,这台电脑上的 Codex 也会一起接好。以后再运行一次,就是更新。

    curl -fsSL https://ifact.net/setup.sh | sh
  2. 02

    在浏览器里点一次允许

    授权页会自己打开;没打开的话,复制终端里给的地址。登录 ifact,没有账号会直接注册。

  3. 03

    重开 Claude Code

    已经开着的要重开一次,才会用上新的连接和 ifact skill。

不想运行脚本(比如在 Windows 上):运行 claude mcp add --transport http --scope user ifact https://ifact.net/mcp,再在 Claude Code 里输入 /mcp 登录。

装好以后,说一句话

它会在你的画布上建项目、做画板,做完给你一个链接。

打开画布它做的东西都在那里。

还可以

在画布上把任务派给这台电脑

运行这一行就能开(安装时加上 --worker 也行)。它在后台运行,开机自动启动,任务交给本机的 Claude Code 或 Codex。

artifact worker install

只让 agent 动一个文件夹

装好以后用 ifact-claude 或 ifact-codex 启动,agent 只能读写 ~/ifact-agent,碰不到你的其他文件。

curl -fsSL https://ifact.net/agent.sh | sh

把本地文件推成画板

安装时顺带装好了 artifact 命令。先登录一次,之后一个网页、一个文件夹或一份 Markdown,推上去就是一张画板;同一个路径再推,就是更新。

artifact login --server https://ifact.net
artifact push ./site

管理和断开

每台电脑、每个连接都列在 设置 → agent 连接 里,随时可以撤销。agent 用你的权限干活,修改记录署它自己的名字。

遇到问题

终端说「没找到 Claude Code、Codex 或 WorkBuddy」

先装好其中一个,再运行一次那一行命令。

授权页没有自己打开

把终端里显示的地址复制到浏览器。验证码 10 分钟内有效,过期了就再运行一次。

agent 说找不到 ifact 的工具

重开客户端,或者在它的 /mcp 里看 ifact 是不是已经连上、登录过。用 Claude 或 ChatGPT 的话,确认这次对话里打开了 ifact 连接器。WorkBuddy 要在 MCP 服务管理里点 ifact 旁边的「信任」,再新开一个对话。

客户端不支持 OAuth 登录

在 设置 → agent 连接 里生成个人访问令牌,按客户端的写法加上请求头 Authorization: Bearer 你的令牌。令牌只显示一次,记得先复制。

Codex 提示 config.toml 里已经有 ifact 的配置

打开 ~/.codex/config.toml,删掉 [mcp_servers.ifact] 那一段,再运行一次。

怎么更新

再运行一次同一行命令。已经接好的连接不会断,只更新 skill 和命令行。

还有问题,看使用文档,或者发邮件到 [email protected]。