---
title: Reasonix
description: 为 Reasonix 配置 VC 的 OpenAI 兼容服务商、模型和密钥。
---

使用支持 Chat Completions 和工具调用的文本模型。以下步骤适用于采用 TOML 配置的当前 Reasonix CLI。

## 安装

安装 Node.js 后执行：

```bash
npm install -g reasonix
reasonix --version
```

## 配置密钥

在启动 Reasonix 的终端设置 VC Key：

<CodeGroup>
```bash macOS / Linux
export VC_API_KEY="YOUR_VC_API_KEY"
```
```powershell Windows PowerShell
$env:VC_API_KEY="YOUR_VC_API_KEY"
```
</CodeGroup>

## 配置项目模型

在项目根目录创建 `reasonix.toml`，把 `YOUR_MODEL_ID` 替换为当前 Key 可用的模型 ID：

```toml
default_model = "vc"

[[providers]]
name = "vc"
kind = "openai"
base_url = "https://sub.vcnovb.cn/v1"
model = "YOUR_MODEL_ID"
api_key_env = "VC_API_KEY"
```

已有文件时合并服务商条目，并把 `default_model` 放在第一个表头之前。`kind = "openai"` 表示使用 OpenAI 兼容请求格式，实际请求发送到 VC 地址。

## 使用配置向导

需要让多个项目共用服务商时，可以运行 `reasonix setup`，添加 OpenAI 兼容服务，填写 VC Base URL、Key 和模型，保存并选择默认模型。

## 开始使用

在包含 `reasonix.toml` 的项目目录、设置过环境变量的同一终端运行：

```bash
reasonix
```

发送「读取 README，概括项目用途，不修改文件」。更换模型后重新启动会话。

## 常见问题

- **找不到密钥**：`api_key_env` 是变量名，密钥值需要设置在 `VC_API_KEY` 中。
- **仍使用旧服务商**：检查项目配置是否覆盖了全局默认模型。
- **旧版只显示 DeepSeek 快速配置**：升级到支持 TOML 自定义服务商的版本，再按本页配置。

完整配置见 [Reasonix 官方使用指南](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/GUIDE.md)。