Novalink 文档中心

Appearance

命令行工具 ​

Claude Code 文档 ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（Key 通过 ANTHROPIC_AUTH_TOKEN 读取，不写进配置文件）：

Windows（PowerShell / CMD 执行）：

setx ANTHROPIC_BASE_URL "https://novalinkchina.com"
setx ANTHROPIC_AUTH_TOKEN "你的key"

macOS / Linux：

export ANTHROPIC_BASE_URL="https://novalinkchina.com"
export ANTHROPIC_AUTH_TOKEN="你的key"

第 3 步 · 启动：环境变量生效后直接运行 claude 即可（Windows 需关闭原终端重新打开）。也可在 ~/.claude/settings.json 的 env 块写入同样的变量作为备选。

提示

验证：运行 claude 后输入任意问题测试；若提示鉴权失败，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。注意：Claude Code 使用 Anthropic Messages API 格式，Base URL 不含 /v1 后缀。

Aider 官网 ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（Key 通过 OPENAI_API_KEY 读取）：

Windows（PowerShell / CMD 执行）：

setx OPENAI_API_KEY "你的key"
setx AIDER_OPENAI_API_BASE "https://novalinkchina.com/v1"
setx AIDER_MODEL "openai/deepseek-v4-flash"

macOS / Linux：

export OPENAI_API_KEY="你的key"
export AIDER_OPENAI_API_BASE="https://novalinkchina.com/v1"
export AIDER_MODEL="openai/deepseek-v4-flash"

第 3 步 · 启动：环境变量生效后运行 aider 即可（Windows 需关闭原终端重新打开）。也可用命令行参数一次性指定：aider --model openai/deepseek-v4-flash --openai-api-base https://novalinkchina.com/v1 --openai-api-key 你的key。

提示

验证：运行 aider 后输入 /help 可见模型已加载；若提示找不到 Key，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。注意：--model 必须以 openai/ 前缀声明使用 OpenAI 兼容协议。

Hermes Agent GitHub ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（Key 不写进配置文件，避免泄露；Hermes 通过 key_env 读取此变量）：

Windows（PowerShell 或 CMD 执行）：

setx NOVALINK_API_KEY "你的key"

macOS / Linux（二选一）：

export NOVALINK_API_KEY="你的key"
# 或写入 ~/.hermes/.env：NOVALINK_API_KEY=你的key

第 3 步 · 修改配置文件

Windows 路径：C:\Users\你的用户名\AppData\Local\hermes\config.yaml

macOS / Linux 路径：~/.hermes/config.yaml

model:
  default: deepseek-v4-flash
  provider: novalink
  base_url: https://novalinkchina.com/v1

providers:
  novalink:
    api: https://novalinkchina.com/v1
    name: novalink
    key_env: NOVALINK_API_KEY
    models:
      deepseek-v4-flash: {}
      deepseek-v4-pro: {}
      claude-sonnet-5: {}

提示

验证：配置完成后执行 hermes doctor 检查连通性。若提示找不到 Key，请确认第 2 步环境变量已生效（Windows 需关闭原终端、重新打开后再运行 hermes）。

出图（图像生成）读的是同一个环境变量名

Hermes 出图走独立的图像后端插件，读的也是 NOVALINK_API_KEY（不用另建 Key）。 插件安装、2K/4K 尺寸规则与排错见支持包说明页 /static/download/novalink-2k4k-说明.html。 旧版本页用过 NOVALINK_KEY：你自己的 config.yaml 里写的是哪个名字，就设哪个环境变量； 出图插件两个名字都认，但新配置请统一写成 NOVALINK_API_KEY。

OpenCode GitHub ​

编辑 ~/.config/opencode/opencode.json：

{
  "provider": {
    "novalink": {
      "apiKey": "your-key-here",
      "baseURL": "https://novalinkchina.com/v1"
    }
  },
  "model": {
    "provider": "novalink",
    "name": "deepseek-v4-flash"
  }
}

提示

需 @ai-sdk/openai-compatible 包支持。修改后重启 OpenCode 生效。

Goose GitHub ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（Key 通过 OPENAI_API_KEY 读取）：

Windows（PowerShell / CMD 执行）：

setx GOOSE_PROVIDER openai
setx OPENAI_HOST "https://novalinkchina.com"
setx OPENAI_API_KEY "你的key"

macOS / Linux：

export GOOSE_PROVIDER=openai
export OPENAI_HOST="https://novalinkchina.com"
export OPENAI_API_KEY="你的key"

第 3 步 · 启动：环境变量生效后运行 goose 即可（Windows 需关闭原终端重新打开）。也可使用自定义 Provider JSON（~/.config/goose/config.yaml）写入 baseUrl 与 apiKey 作为备选。

提示

验证：运行 goose 后输入问题测试；若提示无 Key，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。

Codex CLI GitHub ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（Key 通过 OPENAI_API_KEY 读取）：

Windows（PowerShell / CMD 执行）：

setx OPENAI_BASE_URL "https://novalinkchina.com/v1"
setx OPENAI_API_KEY "你的key"

macOS / Linux：

export OPENAI_BASE_URL="https://novalinkchina.com/v1"
export OPENAI_API_KEY="你的key"

第 3 步 · 启动：环境变量生效后运行 codex 即可（Windows 需关闭原终端重新打开）。

提示

验证：运行 codex 后输入需求测试；若提示鉴权失败，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。注意：Codex CLI 会自动加载 ~/.codex/mcp.json 中的 MCP 工具配置。

Gemini CLI GitHub ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（OpenAI 兼容模式，Key 经 OPENAI_API_KEY 读取）：

Windows（PowerShell / CMD 执行）：

setx OPENAI_API_KEY "你的key"
setx OPENAI_BASE_URL "https://novalinkchina.com/v1"
setx OPENAI_MODEL "deepseek-v4-flash"

macOS / Linux：

export OPENAI_API_KEY="你的key"
export OPENAI_BASE_URL="https://novalinkchina.com/v1"
export OPENAI_MODEL="deepseek-v4-flash"

第 3 步 · 启动：环境变量生效后运行 gemini 即可（Windows 需关闭原终端重新打开）。注：接 Novalink 需使用支持 OpenAI 兼容端点的 Gemini CLI 构建——官方版通过 OPENAI_* 环境变量开启兼容模式；若你的版本不支持，可改用社区版 npx @quantum-ai/gemini-cli。

提示

验证：运行 gemini 后输入问题测试；若提示找不到 Key，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。注意：Gemini CLI 的 OpenAI 兼容模式要求模型支持工具调用与流式输出。

Qwen Code GitHub ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（Key 经 NOVALINK_KEY 读取，不写进配置文件）：

Windows（PowerShell / CMD 执行）：

setx NOVALINK_KEY "你的key"

macOS / Linux：

export NOVALINK_KEY="你的key"

第 3 步 · 修改配置文件：编辑 ~/.qwen/settings.json（Windows 为 C:\Users\你的用户名\.qwen\settings.json）：

{
  "modelProviders": {
    "openai": [{
      "id": "deepseek-v4-flash",
      "name": "NovaLink deepseek-v4-flash",
      "baseUrl": "https://novalinkchina.com/v1",
      "envKey": "NOVALINK_KEY"
    }]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek-v4-flash" }
}

配置完成后运行 qwen 即可（Windows 需关闭原终端重新打开）。也可不设配置文件，直接设置 OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL 环境变量（值同上）作为备选。

提示

验证：运行 qwen 后输入 /model 可切换模型；若提示无 Key，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。

GitHub Copilot CLI 文档 ​

第 1 步 · 获取 API Key：登录 NovaLink 后台，给自己创建一个 API Key（方式与普通用户相同）。
生成的 Key 为 48 位随机串，复制后直接可用；按 OpenAI 习惯写成 sk- 开头也完全等效。

第 2 步 · 设置环境变量（BYOK 模式，Key 经 COPILOT_PROVIDER_API_KEY 读取）：

Windows（PowerShell / CMD 执行）：

setx COPILOT_PROVIDER_BASE_URL "https://novalinkchina.com/v1"
setx COPILOT_PROVIDER_API_KEY "你的key"
setx COPILOT_PROVIDER_TYPE openai
setx COPILOT_MODEL "deepseek-v4-flash"
setx COPILOT_OFFLINE true

macOS / Linux：

export COPILOT_PROVIDER_BASE_URL="https://novalinkchina.com/v1"
export COPILOT_PROVIDER_API_KEY="你的key"
export COPILOT_PROVIDER_TYPE=openai
export COPILOT_MODEL="deepseek-v4-flash"
export COPILOT_OFFLINE=true

第 3 步 · 启动：环境变量生效后运行 copilot 即可（Windows 需关闭原终端重新打开）。COPILOT_OFFLINE=true 可跳过 GitHub 登录，仅与 Novalink 通信。

提示

验证：运行 copilot 后输入需求测试；若提示无 Key，请确认第 2 步环境变量已生效（Windows 需关闭原终端重新打开）。注意：Copilot CLI 需先安装（copilot 命令），且所用模型须支持工具调用与流式输出。

Kimi Code CLI GitHub ​

（品牌名 Kimi Code CLI，安装：pip install kimi-cli，可执行文件 kimi）

第 1 步 · 获取 API Key：登录 NovaLink 后台，创建一个 API Key（48 位随机串，sk- 前缀等效）。

第 2 步 · 编辑配置文件：~/.kimi/config.toml（Windows：%USERPROFILE%\.kimi\config.toml），添加 Novalink 供应商与模型：

toml
[providers.novalink]
type = "openai_legacy"
base_url = "https://novalinkchina.com/v1"
api_key = "你的key"

[models.deepseek-v4-flash]
provider = "novalink"
model = "deepseek-v4-flash"
max_context_size = 1000000

[models.claude-sonnet-5]
provider = "novalink"
model = "claude-sonnet-5"
max_context_size = 1000000

default_model = "deepseek-v4-flash"

也可不写 api_key，改用环境变量（仅对 openai_legacy 类型供应商生效）：

export OPENAI_BASE_URL="https://novalinkchina.com/v1"
export OPENAI_API_KEY="你的key"

第 3 步 · 使用：kimi 交互运行；或 kimi --model deepseek-v4-flash "你好" 单次指定。--model 引用的是 [models] 下的别名键，不带供应商前缀。

提示

Kimi CLI 的 /login 向导只内置 Kimi Code / Moonshot 官方平台，第三方端点需手动编辑 ~/.kimi/config.toml 后使用；[models] 别名不要包含 thinking / reason 字样（会触发强制思考模式，第三方端点可能拒绝）；联网搜索工具仅官方平台可用。

Pi Coding Agent 官网 GitHub ​

第 1 步 · 安装：

bash
curl -fsSL https://pi.dev/install.sh | sh
# 或 npm install -g --ignore-scripts @earendil-works/pi-coding-agent

第 2 步 · 配置自定义 Provider：编辑 ~/.pi/agent/models.json：

json
{
  "providers": {
    "novalink": {
      "baseUrl": "https://novalinkchina.com/v1",
      "api": "openai-completions",
      "apiKey": "$NOVALINK_API_KEY",
      "models": [
        { "id": "deepseek-v4-flash" },
        { "id": "deepseek-v4-pro", "reasoning": true },
        { "id": "claude-sonnet-5" }
      ]
    }
  }
}

第 3 步 · 使用：运行 pi 后按 Ctrl+L 或输入 /model 选择模型，或用 --model novalink/deepseek-v4-flash 直接指定。

提示

apiKey 支持环境变量（$NOVALINK_API_KEY，先 setx NOVALINK_API_KEY "你的key" 或写入 ~/.pi/agent/auth.json）。配置文件在 /model 打开时会自动重载，修改后无需重启。模型若支持思考模式，加 "reasoning": true；Novalink 网关对不支持 developer 角色的模型会自动兼容处理。

Crush GitHub ​

终端 TUI 编程代理（安装方式见官方 README）。配置写在 crushrc（Unix：~/.config/crush/crushrc；Windows：%USERPROFILE%\.config\crush\crushrc），在其中追加：

bash
provider add novalink --type openai-compat --base-url https://novalinkchina.com/v1 --api-key 你的key
model add novalink/deepseek-v4-flash
model large novalink/deepseek-v4-flash

验证：运行 crush 后提问；或无头运行 crush run -m novalink/deepseek-v4-flash "你好"。

提示

Crush 不读取 OPENAI_BASE_URL / ANTHROPIC_BASE_URL 环境变量，Base URL 必须在 provider 配置里显式给出；OpenAI 兼容格式端点含 /v1（https://novalinkchina.com/v1），若改用 Anthropic 格式则用 --type anthropic 且地址不带 /v1（https://novalinkchina.com）。

ShellGPT GitHub ​

第 1 步 · 安装：pip install shell-gpt（命令为 sgpt）。

第 2 步 · 配置环境变量：

Windows（PowerShell / CMD）：

setx OPENAI_API_KEY "你的key"
setx API_BASE_URL "https://novalinkchina.com/v1"
setx DEFAULT_MODEL "deepseek-v4-flash"

macOS / Linux：

export OPENAI_API_KEY="你的key"
export API_BASE_URL="https://novalinkchina.com/v1"
export DEFAULT_MODEL="deepseek-v4-flash"

或写入配置文件 ~/.config/shell_gpt/.sgptrc（Windows 同路径在 %USERPROFILE%\.config\shell_gpt\）：

OPENAI_API_KEY=你的key
API_BASE_URL=https://novalinkchina.com/v1
DEFAULT_MODEL=deepseek-v4-flash

第 3 步 · 使用：sgpt "你好"；临时换模型 sgpt --model claude-sonnet-5 "..."。

提示

API_BASE_URL 的值会原样传给 OpenAI SDK，必须包含 /v1；sgpt 默认开启本地缓存，同 prompt 二次命中缓存，调试时可加 --no-cache。

omp（Oh My Pi） GitHub ​

终端编码环境（omp）。配置目录 ~/.omp/agent/（Windows：%USERPROFILE%\.omp\agent\）：models.yml 声明自定义供应商，同目录 .env 存放密钥，config.yml 指定各角色默认模型。

第 1 步 · 在 models.yml 追加 Novalink 供应商：

yaml
providers:
  novalink:
    baseUrl: https://novalinkchina.com/v1
    api: openai-completions
    apiKey: NOVALINK_API_KEY
    models:
      - id: deepseek-v4-flash
        name: DeepSeek V4 Flash
      - id: claude-sonnet-5
        name: Claude Sonnet 5
      - id: hy4-preview
        name: Hunyuan 4 Preview

第 2 步 · 在 .env 写入密钥（无 export 前缀）：

NOVALINK_API_KEY=你的key

第 3 步 · 切换默认模型：在 config.yml 的 modelRoles 中把角色指向 Novalink 模型，如 default: novalink/deepseek-v4-flash，重启 omp 生效。

提示

模型引用格式为 <供应商>/<模型id>（如 novalink/claude-sonnet-5）；omp 的自定义供应商一律走 OpenAI 兼容协议（api: openai-completions）。

Reasonix ​

TOML 配置的 CLI / 桌面 AI agent。全局配置在 %APPDATA%\reasonix\config.toml（Windows；macOS / Linux 请在对应配置目录放置，以你的安装为准），密钥放同目录 .env。

第 1 步 · 在 config.toml 追加 Novalink 供应商：

toml
[[providers]]
name = "novalink"
kind = "openai"
base_url = "https://novalinkchina.com/v1"
api_key_env = "NOVALINK_API_KEY"
models = ["deepseek-v4-flash", "claude-sonnet-5", "hy4-preview"]

default_model = "novalink/deepseek-v4-flash"

第 2 步 · 在同目录 .env 写入密钥：

NOVALINK_API_KEY=你的key

第 3 步 · 使用：reasonix doctor 检查连通后提问；模型引用一律写 <供应商>/<模型id>（如 novalink/claude-sonnet-5）。

提示

Reasonix 的供应商与密钥只在全局配置目录生效，项目级 reasonix.toml 只覆盖权限等非供应商字段；api_key_env 指向 .env 里的环境变量名，配置里不写明文 Key。

Novalink API 中转站

Copyright © 2026 Novalink