Windows / PowerShell / WSL

先确定你在哪个环境运行#

Windows 与 WSL 可以访问彼此部分文件，但不是同一个运行环境。Windows 安装了 Node.js，不代表 WSL 已经有 Linux 版 Node；在一个环境设置变量，也不代表另一个环境的进程能读到。

准备 Node.js 与终端#

需要使用 Node.js 客户端时，从 Node.js 官网选择当前 LTS 和你的系统版本。安装完成后重新打开终端。已有正常环境无需重复安装。

node --version
npm.cmd --version
curl.exe --version

PowerShell 中若 npm 指向脚本并提示执行策略限制，可使用 npm.cmd。不必为了安装包而全局降低系统的脚本保护。

设置当前会话的变量#

$env:SOTAAI_API_KEY = 'YOUR_API_KEY'
$env:SOTAAI_BASE_URL = 'https://sotaai.org'
$env:SOTAAI_MODEL = 'YOUR_MODEL'

在同一终端启动客户端。新开窗口后需重新设置临时变量，或按自己的密钥管理方式配置长期使用。不要把含真实密钥的终端历史或截图公开。

使用 WSL 时的检查#

pwd
command -v node
command -v npm
node --version
npm --version

优先使用 Linux 原生工具链。如果输出指向 Windows 磁盘中的 Node/npm，先核对你的环境设计。命令、依赖、项目路径与配置目录应属于同一套运行环境。