需Windows 11 22H2+/macOS≥14.0/Linux glibc≥2.31且Node.js≥v18.19.0；npm≥9.0.0；用npm install -g @qoder-ai/qodercli等任一方式装CLI；首次运行自动登录鉴权；建SKILL.md含{{ run_script "hello.py" }}及scripts/hello.py脚本后，执行qodercli quest --prompt启动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在本地快速跑通Qoder平台，完成从零安装到执行第一个自动化脚本的全流程，但卡在环境不兼容、CLI装不上或脚本调用失败这三关中的任意一环。
确认系统与Node.js基础环境
Windows用户必须使用Windows 11 22H2及以上版本；macOS需≥14.0（执行sw_vers -productVersion验证）；Linux用户需确保glibc ≥ 2.31。
运行node -v检查Node.js版本——【必须为v18.19.0或更高】，低于该版本将导致SKILL.md解析失败、Quest Mode无法启动。
若未安装，直接前往https://nodejs.org/下载LTS版安装包，勾选“Add to PATH”选项，避免后续手动配置。
npm版本需≥9.0.0，执行npm install -g npm@latest升级即可，无需卸载重装。
安装Qoder CLI（三选一，任选其一）
方法一：NPM全局安装（推荐有Node环境的Windows/macOS/Linux用户）
执行npm install -g @qoder-ai/qodercli，完成后运行qodercli --version，看到非空输出即成功。
方法二：curl脚本安装（仅限Linux/macOS原生终端）
执行curl -fsSL https://qoder.com/install | bash，脚本会自动检测系统、下载二进制、写入PATH并提示“Installation complete”。
【Windows用户执行此命令会直接报错退出，切勿尝试】
方法三：WSL2代理安装（Windows无管理员权限场景）
先启用WSL2，进入Ubuntu发行版，依次执行：
① sudo apt update
② sudo apt install curl
③ curl -fsSL https://qoder.com/install | bash
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
完成身份鉴权与首个Skill初始化
首次运行任意qodercli命令（如qodercli list-skills）时，CLI会自动弹出登录引导。
选择/login → 选“login with browser”，系统将在默认浏览器打开OAuth授权页，完成扫码或账号密码认证后，终端自动写入凭证缓存。
创建项目目录并进入：mkdir my-qoder-project && cd my-qoder-project。
在该目录下新建SKILL.md文件，写入最简声明：
{{ run_script "hello.py" }}
编写并运行第一个Python脚本
在项目根目录下创建scripts/子目录：mkdir scripts。
在scripts/中新建hello.py，内容如下：
#!/usr/bin/env python3
import sys, json
data = json.load(sys.stdin)
print(json.dumps({"message": "Hello from Qoder script!", "input_received": bool(data)}))
赋予可执行权限（Linux/macOS）：chmod +x scripts/hello.py。
Windows用户跳过此步，依赖Python解释器注册机制执行。
执行qodercli quest --prompt "run hello script"，Qoder将解析SKILL.md、注入上下文、调用脚本，并在终端输出JSON结果。
