命令行工具

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 官网

第 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/hy3"

macOS / Linux：

export OPENAI_API_KEY="你的key"
export AIDER_OPENAI_API_BASE="https://novalinkchina.com/v1"
export AIDER_MODEL="openai/hy3"

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

提示

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

Hermes Agent GitHub

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

Windows（PowerShell 或 CMD 执行）：

setx NOVALINK_KEY "你的key"

macOS / Linux（二选一）：

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

第 3 步 · 修改配置文件

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

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

model:
  default: hy3
  provider: novalink
  base_url: https://novalinkchina.com/v1

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

提示

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

OpenCode GitHub

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

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

提示

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

Goose GitHub

第 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

第 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

第 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 "hy3"

macOS / Linux：

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

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

提示

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

Qwen Code GitHub

第 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": "hy3",
      "name": "NovaLink hy3",
      "baseUrl": "https://novalinkchina.com/v1",
      "envKey": "NOVALINK_KEY"
    }]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "hy3" }
}

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

提示

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

GitHub Copilot CLI 文档

第 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 "hy3"
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="hy3"
export COPILOT_OFFLINE=true

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

提示

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

提示

关于 Kimi（月之暗面）：Kimi 目前没有官方独立的 CLI 编码工具，但其 API 为 OpenAI 兼容。你可以用任意 OpenAI 兼容客户端接入 Novalink：例如在下方「OpenAI SDK」示例中把 base_url 指向 Novalink；或在 Qwen Code 的 openai provider 中将 baseUrl 设为 Novalink、模型填 Kimi 系列（如 kimi-k2.7-code）；也可在任意支持 OPENAI_BASE_URL 的工具中填写 Novalink 地址与你的 Key。

命令行工具 ​

Claude Code 文档 ​

Aider 官网 ​

Hermes Agent GitHub ​

OpenCode GitHub ​

Goose GitHub ​

Codex CLI GitHub ​

Gemini CLI GitHub ​

Qwen Code GitHub ​

GitHub Copilot CLI 文档 ​

命令行工具

Claude Code 文档

Aider 官网

Hermes Agent GitHub

OpenCode GitHub

Goose GitHub

Codex CLI GitHub

Gemini CLI GitHub

Qwen Code GitHub

GitHub Copilot CLI 文档