OpenMagic OpenMagic API Unified access for modern AI workflows
Project Docs Open client setup
Docs / Agent Starter

从“我想试试 AI 写代码”到第一条可用 Agent 工作流。

这页不是只告诉老用户怎么填 Base URL，而是给新用户创造需求：选一个流行工具，复制一条命令，跑通第一个任务。

Open client setup Open console

先说清楚：Agent 教程还没有“全部完成”。

当前已完成的是第一批高优先级工具的可用教程和一键脚本入口：Codex、Claude Code、Cline、Roo Code、Continue、Cursor、LobeChat/NextChat、Windsurf。后续还要继续补截图级教程、版本差异、国内镜像缓存和更多工具。

安装策略

Install strategy

当前策略：平台优先级按用户规模排序：Windows PowerShell 第一，macOS 第二，Linux/WSL 第三。第三方工具优先从官方 npm/GitHub 安装，OpenMagic 提供本地 bootstrap 脚本来自动写入 Base URL、API Key、模型建议和配置说明。

为什么不直接改第三方包：私自改包会带来版权、更新和安全风险。先不改包，先做一键配置。后续可以做官方包缓存镜像、版本锁定、校验 hash、预配置模板，但不应让用户安装来源不明的魔改包。

国内用户优化：脚本托管在 OpenMagic 本站，用户只需要访问 `api.openmagic.ai`。npm/GitHub 下载慢的问题，下一阶段做缓存镜像和离线包索引。

4 步跑通

极简路径，不讲废话。

1. 注册

创建账号并完成邮箱验证。

2. 充值

先买低门槛试用包。

3. 复制 Key

在 Console 复制 API Key。

4. 复制命令

选下面的 Agent，点 Copy。

选择你的 Agent

Choose your agent. Pick one, do not compare forever.

Ready · OpenAI-compatible

Codex CLI

Terminal coding agent for reading, editing, and testing code.

适合：Beginner friendly

Windows PowerShell（首选）

$env:OPENMAGIC_API_KEY="sk-om-..."; iwr https://api.openmagic.ai/assets/install/openmagic-agent-setup.ps1 -UseB | iex

macOS

OPENMAGIC_API_KEY="sk-om-..." bash <(curl -fsSL https://api.openmagic.ai/assets/install/openmagic-agent-setup.sh) codex

Linux / WSL

OPENMAGIC_API_KEY="sk-om-..." bash <(curl -fsSL https://api.openmagic.ai/assets/install/openmagic-agent-setup.sh) codex

手动配置

OPENAI_API_KEY=sk-om-... OPENAI_BASE_URL=https://api.openmagic.ai/v1 codex

注意：Start with a small folder. Ask it to explain before editing.

第一次任务模板

Copy a safe first prompt.

请阅读当前目录，告诉我这个项目的启动方式、主要目录、风险点。不要改文件。

请阅读当前目录，告诉我这个项目的启动方式、主要目录、风险点。不要改文件。

修复这个报错，改动前先说明会动哪些文件，改完后运行测试。

修复这个报错，改动前先说明会动哪些文件，改完后运行测试。

根据当前代码生成 README 的安装和运行部分，保持简洁。

根据当前代码生成 README 的安装和运行部分，保持简洁。

写一个脚本检查依赖、环境变量和端口占用，不要删除任何文件。

写一个脚本检查依赖、环境变量和端口占用，不要删除任何文件。

安全边界

新手用户必须看到。

规则 原因
不要把生产密钥粘到公开 Issue 或截图里 API Key 泄露会产生真实费用。
第一次运行用低额度 Key 防止错误循环调用造成浪费。
让 Agent 先解释计划再改文件 降低误删和大范围重构风险。
不要批准你看不懂的删除/重置命令 尤其是 git reset、rm -rf、数据库 drop。

Warning: session_name(): Cannot change session name when headers already sent in /www/wwwroot/api.openmagic.ai/lib/UserSession.php on line 13

Warning: session_start(): Cannot start session when headers already sent in /www/wwwroot/api.openmagic.ai/lib/UserSession.php on line 14
Agent setup Start now