NextAI 产品文档

Appearance

在 Claude Code 中使用 NextAI API ​

学习如何配置 Claude Code 使用 NextAI API 使用最新的 Claude 模型。

什么是 Claude Code？ ​

Claude Code 是 Anthropic 推出的官方命令行 AI 编程助手，运行在您的终端中，帮助您更快地将想法转化为代码。它可以：

  • 从描述构建功能 - 用自然语言说明需求，自动编写代码
  • 调试和修复问题 - 分析代码库并实施修复
  • 代码库导航 - 回答关于项目结构的问题
  • 自动化繁琐任务 - 处理 lint、解决合并冲突、生成文档

前置准备 ​

安装 Claude Code ​

确保您已安装 Node.js 18 或更高版本，然后全局安装 Claude Code：

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

获取 NextAI API 令牌 ​

1. 登录 NextAI API 控制台 ​

访问 NextAI API 登录或注册账号。

2. 创建令牌 ​

在控制台中新建一个令牌，选择 Claudcode 分组：

  • 进入控制中心
  • 点击"新建令牌"
  • 选择 Claudcode 分组
  • 保存并复制以 sk- 开头的 API 密钥

配置方式 ​

Claude Code 支持两种配置方式，推荐使用 方式一 以获得更好的持久化效果。

方式一：使用配置文件（推荐） ​

1. 创建或编辑配置文件 ​

Claude Code 的配置文件位于 ~/.claude/settings.json。

创建配置文件（如果不存在）：

js
mkdir -p ~/.claude
touch ~/.claude/settings.json

2. 添加 NextAI API 配置 ​

编辑 ~/.claude/settings.json 文件，添加以下内容：

js
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nextaicore.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_TOKEN_HERE"
  }
}

参数说明：

  • ANTHROPIC_BASE_URL: NextAI API 的 接口地址
  • ANTHROPIC_AUTH_TOKEN: 您在 NextAI API 控制台创建的令牌

将 YOUR_API_TOKEN_HERE 替换为您的实际 NextAI API 令牌。

NextAI API 会自动为您提供最新版本的 Claude 模型，无需手动指定模型版本。

方式二：使用环境变量 ​

如果您只想临时使用 NextAI API，可以通过环境变量配置：

macOS / Linux ​

js
export ANTHROPIC_BASE_URL="https://api.nextaicore.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_TOKEN_HERE"

Windows (PowerShell) ​

js
$env:ANTHROPIC_BASE_URL="https://api.nextaicore.com"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_TOKEN_HERE"

Windows (CMD) ​

js
set ANTHROPIC_BASE_URL=https://api.nextaicore.com
set ANTHROPIC_AUTH_TOKEN=YOUR_API_TOKEN_HERE

环境变量只在当前终端会话中有效。如需持久化配置，请使用配置文件方式。

启动和验证 ​

1. 启动 Claude Code ​

进入您的项目目录并启动 Claude Code：

js
cd your-project
claude

首次启动时，Claude Code 会读取配置文件中的设置。

2. 验证配置 ​

在 Claude Code 中运行以下命令验证配置是否正确：

js
/status

如果配置成功，您应该能看到连接状态信息。

3. 测试调用 ​

尝试发送一个简单的请求测试连接：

js
你好，请帮我创建一个 Python 的 hello world 程序

如果 Claude Code 正常响应，说明配置成功！

常见问题 ​

配置后无法连接？

  • 检查令牌是否正确 - 确保复制了完整的 NextAI API 令牌
  • 检查 URL 是否正确 - 确认为 https://api.nextaicore.com
  • 重启 Claude Code - 修改配置后需要重启才能生效
  • 检查网络连接 - 确保能够访问 NextAI API 服务
  • 查看错误信息 - 运行 /status 查看详细错误信息

如何切换回官方 API？

删除或注释掉配置文件中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，或取消环境变量设置。

配置文件位置在哪？

  • macOS/Linux: ~/.claude/settings.json
  • Windows: C:\Users\YourUsername\.claude\settings.json

NextAI API 支持哪些 Claude 模型？

NextAI API 会自动为您提供最新版本的模型，无需手动更新配置。

配置文件格式错误怎么办？

确保 settings.json 文件格式正确：

  • 使用双引号，不要使用单引号
  • 确保 JSON 格式有效（可以使用在线 JSON 验证工具）
  • 如果遇到问题，可以先使用空对象 {} 测试，然后再添加配置

更多详细信息请参考 Claude Code 官方文档 。