安装与配置

本指南帮助你在 macOS 或 Windows 上完成 Noxia 所需的环境搭建。下面以 Claude Code 作为 agent 工具为例，全程约 5 分钟。

对终端不熟悉？推荐使用 CCSwitch 图形化工具，无需手动敲命令即可完成下文的第 2、5 步。

前置条件

一个 Noxia 账户（用于第 6 步授权）。
已安装 Node.js 18 及以上版本（第 4 步用 npx 安装 Skill 时需要；若用 npm 方式安装 Claude Code 也需要）。

1. 安装 agent 工具（Claude Code）

macOS / Linux：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

或使用 npm（跨平台）：

npm install -g @anthropic-ai/claude-code

安装完成后，验证版本：

claude --version

2.（可选）配置自定义模型 API

如果你没有 Claude 订阅，可以让 Claude Code 接入兼容 Anthropic 接口的第三方大模型（如 DeepSeek、通义千问等）。推荐在 Claude Code 的配置文件中完成，编辑 ~/.claude/settings.json（Windows 为 C:\Users\<用户名>\.claude\settings.json，文件不存在则新建），在 env 下填入服务商提供的地址、密钥与模型名称。

以 DeepSeek 为例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的-API-Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

各字段含义：

ANTHROPIC_BASE_URL：服务商的 Anthropic 兼容接口地址。
ANTHROPIC_AUTH_TOKEN：你在该服务商申请的 API Key。
ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL：将 Claude 的 Opus / Sonnet / Haiku 三档分别映射到服务商的具体模型；Claude Code 会按任务复杂度自动选择对应档位。

具体地址、密钥与可用模型名称请以服务商文档为准（参考阿里云百炼接入示例）。保存后重启 claude 即可生效。

不想手动编辑配置文件？CCSwitch 提供图形界面，可一键切换不同模型服务商。

3. 启动 Claude Code

打开终端，进入你的项目文件夹并启动：

cd /path/to/your-project
claude

如需在交互中跳过逐次权限确认，可加参数（请仅在你信任的项目中使用）：

claude --dangerously-skip-permissions

4. 安装 Noxia 配套 Skill

在项目根目录下，使用 skills 工具一键安装 Noxia 配套 Skill：

npx skills add muwenbo/noxia-skills -a claude-code

该命令会将 noxia-skills 仓库中的全部 Skill 安装到 .claude/skills/ 目录，Claude Code 会自动发现它们。各 Skill 的作用及其在流程中的位置，见 Skill 概览。

5. 配置 Noxia MCP 服务

Noxia 以基于 Streamable HTTP 的 MCP 服务对外提供能力。在项目目录下运行：

claude mcp add --transport http noxia https://api.viknox.com/mcp

你也可以直接在 Claude Code 会话中告诉它：

在本项目中配置一个基于 Streamable HTTP 的 Noxia MCP 服务，地址为 https://api.viknox.com/mcp。

6. 授权访问你的 Noxia 账户

在 Claude Code 交互中输入：

/mcp

依次选择 noxia → Authenticate，浏览器会弹出授权窗口，点击 Allow 即可授权 Claude Code 访问你的 Noxia 账户。

7. 开始

环境就绪。现在可以前往上手体验，用我们提供的模拟数据开始你的第一次变异分析之旅。