Claude Code

先选择使用方式:命令行使用 Claude Code CLI;桌面使用 Claude 桌面应用中的 Code 页面。CLI 可通过 CC Switch 配置本站密钥,桌面接入使用独立配置,请联系小助手。

安装 Claude Code CLI

推荐使用 Claude Code CLI。请先安装 Node.js LTS,再安装 Claude Code CLI 和 CC Switch;CC Switch 是完成本站接入所需的配置组件。

RUNTIME
Node.js LTS

安装 Claude Code CLI 所需的运行环境。

下载 Node.js LTS
加载中...
SETUP
Claude Code CLI

直接下载适合当前系统的官方安装包。

下载 Claude Code CLI
加载中...
REQUIRED
CC Switch 桌面应用

CLI 和桌面版都需要通过 CC Switch 完成本网站的接入配置。

下载 CC Switch 桌面应用
加载中...

安装 Node.js LTS 后,打开 PowerShell(Windows)或 Terminal(macOS),执行下面的命令安装并验证 Claude Code CLI:

PowerShell / Terminal
npm install -g @anthropic-ai/claude-code
claude --version

通过 CC Switch 配置(推荐)

开始前请准备好控制台中的 API 密钥和 Base URL:Claude 使用 Anthropic 兼容地址 https://nusi.si。两项信息需要一起配置。

  1. 1
    打开控制台的 API 密钥

    新用户先创建一把密钥;如果已有可用密钥,直接打开对应密钥的编辑面板。

  2. 2
    选择 Claude Code CLI 或 Claude 桌面应用

    在密钥创建弹窗或编辑面板中,点击“选择 Claude Code 使用方式”。CLI 选择通过 CC Switch 导入;桌面应用选择查看配置指南,使用独立的桌面端接入流程。

  3. 3
    允许打开并完成配置

    首次点击配置时,如果浏览器询问是否通过 ccswitch:// 打开外部应用,请选择允许;如果没有弹窗,直接等待 CC Switch 打开,再按提示完成配置。完成后重新打开 Claude Code CLI 即可使用。

如果想手动配置,可通过 JSON 配置 Claude Code与 CC Switch 二选一
WINDOWSC:\Users\<用户名>\.claude\settings.json
MACOS~/.claude/settings.json

在对应路径创建或编辑 settings.json,保留必要字段并将占位值替换为控制台当前值:

settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://nusi.si",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_HAIKU_MODEL",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_OPUS_MODEL",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_SONNET_MODEL",
    "ANTHROPIC_MODEL": "YOUR_DEFAULT_MODEL"
  },
  "model": "YOUR_DEFAULT_MODEL",
  "skipDangerousModePermissionPrompt": true,
  "theme": "light"
}
配置值会随模型与路由策略更新

不要照搬旧文档中的固定模型名。Base URL 以控制台当前页面为准;可用模型请通过 GET /v1/models 实时读取。

完成第一次验证

  1. 1
    重新启动工具

    关闭并重新打开 PowerShell(Windows)或 Terminal(macOS),然后运行 claude。

  2. 2
    打开测试目录

    进入一个可读取的测试目录,等待 Claude Code CLI 进入交互界面。

第一次验证提示词
先不要修改任何文件。请列出当前目录,并简要说明你看到了什么。
能正常返回目录信息,说明 Claude Code CLI、模型配置、API 密钥与 NUSI 链路已打通。

常见失败排查

现象处理方式
切换配置后仍使用旧值

关闭所有 Claude Code CLI 与终端窗口,确认 CC Switch 当前配置或 settings.json 已保存,再重新启动。

401、403 或提示无效密钥

核对 ANTHROPIC_AUTH_TOKEN,并在控制台确认密钥未过期、未删除。

模型不可用

重新请求 GET /v1/models,复制返回结果中的模型 ID,并同步更新默认模型字段。

JSON 配置无法读取

检查文件路径、逗号和双引号;如果无法确认,优先改用 CC Switch 配置。

还需要在Claude 桌面应用中使用?查看Claude 桌面应用配置指南

NUSI 上手指南 · 持续更新中 ·