环境准备

macOS / Linux 环境准备

安装所需工具，确认终端实际读取的版本。

约 3 分钟更新于 2026-09-07

先检查已有环境

Bash

node --version
npm --version
python3 --version
curl --version

缺哪个工具再安装哪个。仅使用 curl 验证接口时，不必先安装完整的 AI 编程工具链。Node.js 可从官网下载当前 LTS；Linux 也可按发行版与团队规范安装。

Bash

command -v node
command -v npm
command -v python3
pwd

机器可能有多个 Node.js 或 Python。安装包与运行程序应使用同一个环境，避免“已经安装但找不到模块”。Python 项目建议使用独立虚拟环境。

Bash

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

变量在当前 Shell 及其新启动的子进程中生效。修改 Shell 配置文件不会自动改变已经启动的客户端；重新启动相关进程后再验证。

发现内容有误，或有未解答的问题？反馈文档问题 ↗