帮助中心 返回首页
最近更新：2025年12月15日 12:15

Claude Code CLI 完整配置指南

适用场景:专为 Anthropic Claude 模型优化的命令行工具,适合需要在终端或脚本中调用 Claude 的开发者。

配置要点:

  • Node.js 版本:≥18
  • Base URL:https://www.nextai-code.com(Claude 客户端通常无需 /v1)
  • 推荐模型:claude-4-5-sonnet-20250929(最新旗舰)

1. 环境准备

Node.js 环境 (需要 Node.js 18+)

推荐使用命令行工具安装 Node.js,以便于版本管理:

  • macOS (使用 Homebrew):

    brew install node

  • 使用 nvm (推荐跨平台):

    # 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 安装并使用最新 LTS 版本
nvm install --lts
nvm use --lts

  • Windows: 推荐使用 nvm-windows 或 winget:

    winget install OpenJS.NodeJS.LTS

如果以上方式均无法使用,可前往 Node.js 官网 下载安装包。

2. 配置认证

2.1 什么是 cc-switch?

cc-switch 是一个可视化的配置管理工具,用于管理 AI CLI 工具的环境变量配置。

支持的 CLI 工具:

  • Claude Code CLI
  • Codex CLI
  • Gemini CLI

主要作用:

  • 可视化配置 API Key 和 Base URL
  • 自动管理环境变量
  • 支持多个配置快速切换

2.2 安装 cc-switch

访问 GitHub Releases 下载对应版本:

  • macOS: .dmg 文件
  • Windows: .exe 安装包
  • Linux: .AppImage 或 .deb

2.3 配置令牌

  1. 访问 NextAI Code 控制台 - 令牌管理 页面。

  2. 点击 添加令牌,参照下图进行配置:

    • 名称:随意填写(例如 cc)
    • 令牌分组:选择 claude 特价 (或其他 Claude 相关分组)
    • 过期时间:建议选择 永不过期
    • 新建数量:1

    令牌基本信息

  3. 额度与限制设置:

    • 额度:建议开启 无限额度
    • 访问限制:留空(不建议启用模型限制)
    • IP白名单:留空(不建议填写)

    额度与限制

  4. 提交后,复制生成的 sk- 开头的令牌。

2.4 使用 cc-switch 配置 API

  1. 打开 cc-switch,选择 Claude,点击 + 按钮。

    添加供应商

  2. 填写配置:

    • 选择 自定义配置
    • API Key: 你的 NextAI Code 令牌 (sk-...)
    • 请求地址: https://www.nextai-code.com (无需 /v1)
    • 模型: 建议不写,用默认即可

    添加配置

  3. 保存并确保状态为 已启用。

2.5 手动配置环境变量 (可选)

如果不使用 cc-switch,也可以手动配置环境变量:

macOS / Linux:

export ANTHROPIC_AUTH_TOKEN="sk-..." # 你的 NextAI Code 令牌
export ANTHROPIC_BASE_URL="https://www.nextai-code.com"

Windows (PowerShell):

$env:ANTHROPIC_AUTH_TOKEN="sk-..."
$env:ANTHROPIC_BASE_URL="https://www.nextai-code.com"

Windows (CMD):

set ANTHROPIC_AUTH_TOKEN=sk-...
set ANTHROPIC_BASE_URL=https://www.nextai-code.com

3. 安装和验证 CLI

3.1 安装 Claude Code

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

3.2 验证配置

安装完成后,立即测试配置是否成功:

claude --version

如果显示版本号,说明安装成功。然后测试 API 连接:

claude chat "你好"

如果收到 Claude 的回复,说明配置成功!

4. 常见命令与功能

模型选择

Claude CLI 支持指定模型。NextAI Code 支持最新的 Claude 模型:

  • claude-4-5-sonnet-20250929 (最新旗舰,编码能力最强)
  • claude-4-5-opus (超大杯,适合复杂架构设计)
  • claude-4-5-haiku (极速模型,适合简单任务)
claude chat --model claude-4-5-sonnet-20250929 "帮我写一个快速排序"

5. 故障排查

cc-switch 配置后 Claude 无法连接?
  1. 检查 cc-switch 状态:确保配置状态为 已启用
  2. 检查 Base URL:Claude 应为 https://www.nextai-code.com,无需 /v1
  3. 验证令牌:确认复制的令牌完整,格式为 sk- 开头
  4. 重启终端:配置环境变量后需要重启终端
Node.js 版本过低?

Claude CLI 需要 Node.js 18 或更高版本:

  1. 运行 node --version 查看当前版本
  2. 如果版本低于 18,使用 nvm 升级:nvm install --lts && nvm use --lts
  3. 重新安装 Claude CLI
权限错误 (Permission Denied)?

macOS/Linux:

  • 使用 sudo npm install -g @anthropic-ai/claude-code
  • 或配置 npm 全局安装目录到用户目录
额度不足
登录 NextAI Code 控制台 检查余额,必要时充值。