Claude Code 配置教程

本教程涵盖 Claude Code 的三种使用方式，适用于 Windows、macOS 和 Linux：

桌面版（Desktop）

终端版（Terminal）

VS Code 插件版

流程一致：先创建 API 令牌，再安装客户端，最后完成配置。

一、创建 API 令牌

1. 选择模型和分组

打开模型广场，选择需要使用的模型，并确认该模型支持的分组。

不同分组对应不同渠道和计费倍率。通常倍率较高的分组拥有更高的并发能力和稳定性，请根据实际需求选择。

2. 创建令牌

进入 控制台 → 令牌管理 → 添加令牌，选择支持目标模型的分组。

如需提高可用性，可以开启跨分组重试并配置多个分组。当前分组的渠道请求失败时，系统会按顺序尝试后续分组。

保存后复制生成的 API Key，后续配置时需要使用。

请妥善保管 API Key，不要发送给他人，也不要在截图中展示完整内容。

二、安装与配置

以下三种方式任选其一，也可以同时安装。

方式 A：桌面版（Desktop）

1. 下载安装

下载地址：https://claude.ai/download（需要魔法），选择对应系统版本下载安装。

2. 免登录配置

安装完成后打开桌面版，按以下步骤配置：

不要点登录

顶部菜单栏：Help → Troubleshooting → Enable Developer Mode，确认开启后重启软件。

重启后菜单栏出现 Developer → Configure Third-Party Inference。

填入 API 地址 https://www.northrouter.com 和 API Key，点击 Apply Changes，即可跳过账号登录直接聊天。

选择 code 进行对话，右下角可切换模型。

桌面版在此界面直接完成配置，无需修改 settings.json。

方式 B：终端版（Terminal）

终端版适合习惯命令行的用户。安装后需按下方 三、配置文件 完成配置。

1. 官方脚本安装（推荐）

命令来自 Claude Code 官方安装文档。

Windows（打开 PowerShell，无需管理员权限）：

irm https://claude.ai/install.ps1 | iex

若项目位于 WSL 文件系统，请在 WSL 终端中使用下方 macOS/Linux 命令。

macOS / Linux / WSL（打开终端）：

原生安装版本会自动检查更新。Windows 用户可安装 Git for Windows 以使用 Git Bash，否则将使用 PowerShell 执行命令。

2. npm 安装（备选）

已安装 Node.js 22 或更高版本时，可运行：

检查 Node.js 版本：

如需安装或更新 Node.js，请前往 Node.js 官网。

macOS 或 Linux 出现 npm 权限错误时，不建议使用 sudo npm install，请改用 Node.js 版本管理工具后重新安装。

3. 验证安装

出现版本号即表示安装成功。

方式 C：VS Code 插件版

适合希望在编辑器中直接使用的用户，各系统安装方式基本一致。安装后需按下方 三、配置文件 完成配置。

打开 VS Code，进入扩展（Windows/Linux：Ctrl+Shift+X；macOS：Command+Shift+X）。

搜索 Claude Code，找到由 Anthropic 发布的插件，点击安装。

安装完成后，点击侧边栏中的 Claude 图标即可使用。

Cursor、Windsurf 等兼容 VS Code 扩展的编辑器也可尝试安装同一插件。若没看到 Claude 图标，请重启编辑器并确认当前项目已被信任。

三、配置文件（终端版 / VS Code 插件版）

桌面版已在方式 A 中完成配置，可跳过本节。

1. 找到配置目录

终端版与 VS Code 插件版共用同一套用户配置：

系统	配置目录
Windows	`C:\Users\<你的用户名>\.claude`
macOS	`/Users/<你的用户名>/.claude`
Linux	`/home/<你的用户名>/.claude`

.claude 是隐藏目录。macOS 访达中按 Command+Shift+. 显示隐藏文件，Linux 文件管理器通常按 Ctrl+H 显示。

2. 配置 API Key 和模型

在 .claude 目录中创建或打开 settings.json，写入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk开头的密钥",
    "ANTHROPIC_BASE_URL": "https://www.northrouter.com",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "claude-fable-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-5",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  },
  "includeCoAuthoredBy": false,
  "theme": "dark"
}

将 sk开头的密钥 替换为第一步创建的 API Key。模型名称需与模型广场中实际可用的名称一致；使用其他 Claude 模型时请同步修改对应值。

JSON 中的双引号和逗号必须保留，不要在 API Key 前后添加空格。

3. 重启客户端

保存配置后，关闭并重新打开 Claude Code 或 VS Code，使新配置生效。

四、验证与排查

打开任意客户端发送一条测试消息，能正常收到回复即表示配置成功。

如无法使用，请依次检查：

settings.json 是否位于当前用户的 .claude 目录中。

文件名是否正确，Windows 是否被自动添加了 .txt 后缀。

ANTHROPIC_BASE_URL 是否为 `https://www.northrouter.com。

API Key 是否完整、余额是否充足、所选分组是否支持当前模型。

模型名称是否与模型广场中的名称一致。

JSON 格式是否正确，双引号和逗号是否完整。

修改配置后是否已重新启动客户端。

Claude Code 配置教程

一、创建 API 令牌#

1. 选择模型和分组#

2. 创建令牌#

#

二、安装与配置#

方式 A：桌面版（Desktop）#

1. 下载安装#

2. 免登录配置#

方式 B：终端版（Terminal）#

1. 官方脚本安装（推荐）#

2. npm 安装（备选）#

3. 验证安装#

方式 C：VS Code 插件版#

三、配置文件（终端版 / VS Code 插件版）#

1. 找到配置目录#

2. 配置 API Key 和模型#

3. 重启客户端#

四、验证与排查#