---
title: Claude Code
description: 使用 VC 的 Messages 接口配置 Claude Code，设置密钥、模型和服务地址。
---

使用支持 Messages 协议及工具调用的文本模型分组。先从[API 密钥](https://sub.vcnovb.cn/keys)的使用说明获取对应配置。

## 安装

按 [Claude Code 官方安装说明](https://code.claude.com/docs/en/setup)完成安装。在终端执行 `claude --version`，确认命令可用。

## 设置地址、密钥与模型

将下列占位值替换为 VC Key 和该 Key 可用的模型 ID。命令作用于当前终端，在同一终端启动 Claude Code。

<CodeGroup>
```bash macOS / Linux
export ANTHROPIC_BASE_URL="https://sub.vcnovb.cn"
export ANTHROPIC_AUTH_TOKEN="YOUR_VC_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_OPUS_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_SONNET_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_MODEL_ID"
export CLAUDE_CODE_SUBAGENT_MODEL="YOUR_MODEL_ID"
claude
```
```powershell Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://sub.vcnovb.cn"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_VC_API_KEY"
$env:ANTHROPIC_MODEL="YOUR_MODEL_ID"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="YOUR_MODEL_ID"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="YOUR_MODEL_ID"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_MODEL_ID"
$env:CLAUDE_CODE_SUBAGENT_MODEL="YOUR_MODEL_ID"
claude
```
</CodeGroup>

先将各模型项设为同一个可用 ID；需要分别配置主模型与子任务模型时，再替换相应值。已有的 `ANTHROPIC_API_KEY` 或其他服务商配置与本页不一致时，先清理冲突项。

## 保存为长期配置

也可以在用户目录的 `.claude/settings.json` 中合并以下 `env` 字段。Windows 路径为 `%USERPROFILE%\.claude\settings.json`，macOS / Linux 为 `~/.claude/settings.json`。

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://sub.vcnovb.cn",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_VC_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "CLAUDE_CODE_SUBAGENT_MODEL": "YOUR_MODEL_ID"
  }
}
```

保留文件中已有的其他配置，不要将含密钥的文件提交到项目仓库。

## 开始使用

进入项目目录后运行 `claude`。先发送一句普通问候，再尝试读取 README。通过[用量记录](/guides/usage)查看调用与消耗。

## 常见问题

- **404**：基础地址不要加 `/v1/messages`，也不要照搬其他服务商的 `/anthropic` 路径。
- **主对话成功，子任务提示模型不可用**：检查 Haiku、Sonnet、Opus 和子任务模型是否都属于当前 Key 的可用目录。
- **设置后仍连接原服务**：关闭旧进程，从设置了环境变量的终端重新启动，并检查用户及项目级配置。