命令行 Agent

Claude Code

让 Claude Code 通过 NoviaHub 调用模型：安装、配置 settings.json、验证连接、切换模型和常见问题。

Claude Code 是 Anthropic 推出的编程 Agent，在终端（以及 VS Code 等 IDE）里运行，可以阅读和修改你的代码、执行命令。它通过 Anthropic Messages 协议调用模型，把接口地址指向 NoviaHub 后，就可以用 NoviaHub 的余额调用模型。

前提条件

一把 NoviaHub API 密钥，见 API 密钥；账户里有余额，见钱包与充值。
操作系统：macOS 13+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+；内存 4 GB 以上。

安装

官方推荐使用原生安装程序（会自动更新）：

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

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

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

其他官方安装方式（这几种不会自动更新）：

Homebrew：brew install --cask claude-code
WinGet：winget install Anthropic.ClaudeCode
npm：npm install -g @anthropic-ai/claude-code（需要 Node.js 22 或更新版本；官方不建议加 sudo）

安装后运行下面两条命令确认安装成功：

claude --version
claude doctor

配置 NoviaHub

Claude Code 会在接口地址后面自动拼上 /v1/messages，所以地址只填 https://noviahub.com，不要带 /v1。

方式一：写进 settings.json（推荐，长期有效）

打开（没有就新建）用户级配置文件：
- macOS / Linux：~/.claude/settings.json
- Windows：%USERPROFILE%\.claude\settings.json

写入下面的内容。把 sk-... 换成你的 NoviaHub 密钥；如果文件里已经有其他设置，只需把 env 里的这几项合并进去：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://noviahub.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

配置项	作用
`ANTHROPIC_BASE_URL`	接口地址，填 `https://noviahub.com`。
`ANTHROPIC_AUTH_TOKEN`	你的 NoviaHub 密钥，以 `Authorization: Bearer` 请求头发送，立即生效。
`ANTHROPIC_MODEL`	默认使用的模型。
`ANTHROPIC_DEFAULT_OPUS_MODEL` / `_SONNET_MODEL` / `_HAIKU_MODEL`	可选。Claude Code 里 opus / sonnet / haiku 这三个别名分别对应到哪个模型；haiku 档还会被用于后台功能。

保存文件，重新打开终端后运行 claude。

可以把密钥保存在环境变量 NOVIAHUB_API_KEY 里（见下方「方式二」开头），然后在 settings.json 里用 apiKeyHelper 读取它，代替 ANTHROPIC_AUTH_TOKEN：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://noviahub.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  },
  "apiKeyHelper": "printenv NOVIAHUB_API_KEY"
}

apiKeyHelper 是一条命令，它输出的内容会作为密钥，同时放进 Authorization 和 x-api-key 两个请求头；从 Claude Code v2.1.227 起，这条命令只能输出密钥本身。NoviaHub 模型详情页「API 接入」里生成的 Claude Code 配置用的就是这种写法，不过其中的变量名是 NEW_API_KEY，两者只是名字不同，选一个统一使用即可。

方式二：在终端里临时设置

适合临时试用。下面先把密钥长期保存到环境变量 NOVIAHUB_API_KEY，再设置 ANTHROPIC_* 这几个变量；后者只对当前终端窗口有效，关掉窗口就失效：

macOS / Linux / WSL
Windows PowerShell

# macOS 默认用 zsh；Linux 用 bash 的话把 ~/.zshrc 换成 ~/.bashrc
echo 'export NOVIAHUB_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

export ANTHROPIC_BASE_URL="https://noviahub.com"
export ANTHROPIC_AUTH_TOKEN="$NOVIAHUB_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

# 永久保存密钥；setx 对当前窗口不生效，需要新开一个 PowerShell 窗口
setx NOVIAHUB_API_KEY "sk-..."

# 在新窗口里：
$env:ANTHROPIC_BASE_URL = "https://noviahub.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:NOVIAHUB_API_KEY
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
claude

验证

运行 claude，输入 /status 并回车。
在「Status」页签里，应该能看到 Anthropic base URL 一行显示 https://noviahub.com，以及一行显示密钥来自哪个变量（例如 ANTHROPIC_AUTH_TOKEN）。
随便问一句话，能正常回答就说明接通了。再到 NoviaHub 控制台的使用日志里，可以看到这次调用和费用。

切换模型

Claude Code 按下面的优先级决定用哪个模型（从高到低）：

会话中输入的 /model <模型ID>，例如 /model claude-opus-5；
启动参数 claude --model <模型ID>；
环境变量 ANTHROPIC_MODEL；
settings.json 里的 model 设置。

模型必须支持 Anthropic Messages 协议：到模型&价格打开模型详情，端点标签里要有 Anthropic。2026-09-28 NoviaHub 上带这个标签的 Claude 模型有 claude-opus-5-5、claude-opus-5、claude-sonnet-5、claude-haiku-4-5、claude-fable-5-1、claude-fable-5、claude-opus-4-8，模型会增减，请以模型页为准。

官方文档说明：接口地址指向自定义网关时，Claude Code 会把你填的模型 ID 原样发送、不做检查。一些非 Claude 模型（例如 gpt-6-sol、deepseek-v4-flash）在 NoviaHub 上也带有 Anthropic 标签，可以用这个协议调用；但 Claude Code 官方没有说明对非 Claude 模型的支持程度，能否正常使用工具调用等功能需要你自己试用确认。

/model 的模型选择列表默认不会从网关读取模型。设置环境变量 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 后，Claude Code 会请求 NoviaHub 的 /v1/models，但只保留 ID 里含有 claude 或 anthropic 的模型。

常见问题

提示认证冲突（auth conflict） 之前用 claude.ai 账号登录过 Claude Code 时会出现。在 Claude Code 里运行 /logout 退出官方账号即可。

返回 400，提示有未知字段 在 settings.json 的 env 里加上 "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"，关闭实验性功能后重试。

返回 401 Invalid token（无效的令牌） 密钥写错了，或者这把密钥已被禁用、已过期、额度已用完。到「API 密钥」页检查状态，见 API 密钥 · 密钥的四种状态。

返回 403 insufficient_user_quota 账户余额不足，先充值。

有些功能用不了 官方说明：使用网关凭据时，Remote Control 和语音输入不可用；Slack 集成和云端会话始终走 Anthropic 官方。

在 VS Code 插件里使用 官方说明：VS Code 扩展需要在 VS Code 的用户设置里通过 claudeCode.environmentVariables 配置这些环境变量，具体写法见参考资料中的官方页面。

参考资料

以下资料查阅于 2026-09-28：

安装与系统要求：https://code.claude.com/docs/en/setup
接入 LLM 网关：https://code.claude.com/docs/en/llm-gateway-connect
网关协议要求：https://code.claude.com/docs/en/llm-gateway-protocol
模型配置：https://code.claude.com/docs/en/model-config
setx 命令（Windows）：https://learn.microsoft.com/windows-server/administration/windows-commands/setx