#本地环境准备

这一页解决“我电脑上还缺什么工具”的问题。只用网页调试台或桌面聊天客户端时，不一定需要安装这些工具；如果你要用 Codex、Claude Code、Cline、Cursor、Python/Node SDK 或 curl 示例，建议先按本页检查一遍。

#需要安装什么

#打开终端

打开后先运行：

curl --version
git --version
node -v
npm -v
python --version

某条命令提示找不到，就只安装缺失的工具。

#Windows 准备

Windows 用户建议使用 PowerShell。先确认系统有 winget：

winget --version

安装 Git 和 Node.js LTS：

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS

如果你需要 Python：

winget install --id Python.Python.3

安装完成后关闭并重新打开 PowerShell，验证：

git --version
node -v
npm -v
python --version

#PowerShell 提示 npm.ps1 被禁用

如果看到类似错误：

npm.ps1 cannot be loaded because running scripts is disabled on this system.

可以在 PowerShell 中执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

重新打开终端后再试 npm -v。

#macOS 准备

最简单的方式是从 Node.js 官网下载安装 LTS 版本。安装完成后打开终端验证：

node -v
npm -v

如果你已经使用 Homebrew，也可以执行：

brew install git node python

如果提示 brew: command not found，说明你还没有安装 Homebrew。可以先用 Node.js 官网安装包，不必为了文档接入额外学习 Homebrew。

#Linux 准备

Ubuntu / Debian：

sudo apt update
sudo apt install -y curl git nodejs npm python3

Fedora：

sudo dnf install -y curl git nodejs npm python3

验证：

curl --version
git --version
node -v
npm -v
python3 --version

如果发行版仓库里的 Node.js 版本太旧，建议改用 Node.js 官方 LTS 安装方式或团队已有的版本管理工具。

#设置万模API Key

把 API Key 放到环境变量后，命令行工具和 SDK 就可以读取它。

#Windows PowerShell

当前窗口临时生效：

$env:WANMO_API_KEY="sk-..."

长期保存到当前用户：

[Environment]::SetEnvironmentVariable("WANMO_API_KEY", "sk-...", "User")

重新打开 PowerShell 后验证：

echo $env:WANMO_API_KEY

#macOS / Linux

当前终端临时生效：

export WANMO_API_KEY="sk-..."

长期保存：

echo 'export WANMO_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

如果你的 shell 是 Bash：

echo 'export WANMO_API_KEY="sk-..."' >> ~/.bashrc
source ~/.bashrc

#最小验证

#Linux/macOS（Bash）的 curl 测试

确认环境变量可读取后，运行：

curl https://www.wanmoapi.com/v1/chat/completions \
  -H "Authorization: Bearer $WANMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

如果返回模型回复，说明本地终端、Key、Base URL 和模型名已经基本可用。

#Windows PowerShell 的 curl 测试

curl.exe https://www.wanmoapi.com/v1/chat/completions `
  -H "Authorization: Bearer $env:WANMO_API_KEY" `
  -H "Content-Type: application/json" `
  -d '{ \"model\": \"gpt-5.4-mini\", \"messages\": [ { \"role\": \"user\", \"content\": \"你好\" } ] }'

#常见问题

#node 或 npm 仍然找不到

关闭所有终端窗口后重新打开。如果仍然找不到，说明安装目录没有写入 PATH，建议重新安装 Node.js LTS，并勾选添加到 PATH 的选项。

#Windows 执行 curl 后没有用到环境变量

PowerShell 使用 $env:WANMO_API_KEY 读取变量；Git Bash、WSL、macOS、Linux 使用 $WANMO_API_KEY。如果在 PowerShell 中复制 Bash 示例，可以先把命令里的 $WANMO_API_KEY 改成 $env:WANMO_API_KEY。

#公司网络或代理导致请求失败

先用浏览器打开控制台确认能访问万模API，再用在线调试台验证 Key。如果浏览器可用但终端不可用，通常是终端代理或证书问题，需要按公司网络要求配置代理。

#下一步

• 跑通第一个请求：三件套与第一个请求
• 配置 Codex：Codex 接入万模API
• 选择协议：协议选择指南