Claude Code

约 656 字大约 2 分钟

2026-07-21

本页介绍如何通过 settings.json 将 Claude Code 接入 NexAPI。开始前，请先完成环境与 CLI 检查，并准备好 NexAPI API 令牌和令牌分组支持的模型名称。

配置参数

配置项	填写内容
`ANTHROPIC_AUTH_TOKEN`	你的 NexAPI API 令牌
`ANTHROPIC_BASE_URL`	`https://nexapi.ehytech.com`
模型相关配置	令牌分组支持的 Claude 模型名称

请求地址不要以斜杠结尾

Claude Code 使用 https://nexapi.ehytech.com，末尾不要添加 /，也不需要添加 /v1。

步骤一：安装 Claude Code

在终端中运行：

npm install -g @anthropic-ai/claude-code

安装完成后检查版本：

claude --version

步骤二：找到配置文件

Claude Code 的用户配置文件位于：

操作系统	配置文件路径
Windows	`C:\Users\<用户名>\.claude\settings.json`
macOS / Linux	`~/.claude/settings.json`

如果 .claude 目录或 settings.json 不存在，可以手动创建。Windows 用户也可以在文件资源管理器的地址栏输入 %USERPROFILE%\.claude 快速打开。

先备份已有配置

如果 settings.json 已经存在，请先复制备份，并把下面的字段合并到原配置中，不要直接覆盖已有设置。

步骤三：写入 NexAPI 配置

打开 settings.json，写入以下内容。将 sk-xxxxxxxx 替换为自己的 API 令牌，并将示例模型名替换为令牌分组支持的真实模型名称。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://nexapi.ehytech.com",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-opus-4-8",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-4-8"
  },
  "includeCoAuthoredBy": false
}

不要泄露 API 令牌

不要提交或公开包含真实 API 令牌的 settings.json。截图、录屏或寻求帮助前，请完整遮挡令牌；发现泄露后应立即删除并重新创建。

步骤四：启动并验证

保存配置文件，关闭已经运行的 Claude Code 会话，重新打开终端并运行：

claude

发送一条简单消息进行验证。如果修改模型配置后没有生效，请完全退出 Claude Code 后重新启动。

常见问题

现象	检查项
JSON 解析错误	逗号、引号和大括号是否完整，文件是否为合法 JSON
`401` 或认证失败	`ANTHROPIC_AUTH_TOKEN` 是否完整、令牌是否有效
模型不存在或无可用渠道	模型名称是否准确、令牌分组是否支持该模型
无法连接或请求超时	`ANTHROPIC_BASE_URL` 和网络代理是否正确