Claude Mac / Linux 手动安装教程

在 macOS、Linux 或 Windows WSL 上完成 Claude Code 安装、GPT88 环境配置与连通性验证。

适用范围：涉及账户、Key、模型、计费或接口的内容，请以 GPT88 当前控制台和对应 API 文档为准。

GPT88 使用说明 配置界面、客户端字段和连通性检查以 GPT88 当前接入文档为准。

快速开始 · 模型导航 · GPT88 API Key 管理

Claude Code macOS / Linux 手动安装指南

适用范围 本安装教程适用于 macOS、Linux 系统，以及 Windows WSL / Linux 终端用户，完整覆盖 Claude Code 手动安装、环境配置与连通性校验全流程。

关联配套技术文档：

安装前请提前获取 Claude Code 运行所需 GPT88 API Key 与接口请求地址，详细获取指引参考文档：令牌选择与 API 配置

Claude Code 运行依赖 Node.js 运行时环境，未安装环境请按以下步骤操作：

node -v
npm -v

验证成功 终端正常输出版本号，代表 Node.js 与 npm 安装完成。

在终端执行全局安装指令：

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

安装完成后执行版本检测命令：

claude --version

验证成功 终端输出 claude 1.x.x / claude 2.x.x 格式版本号，代表客户端安装成功。

CCSwitch 为 Claude Code 专用环境配置工具，可自动写入 GPT88 接口地址、API Key 等核心环境参数。

配置教程入口：CCSwitch 配置教程
直接下载地址（选择对应系统安装包）：https://github.com/farion1231/cc-switch/releases/tag/v3.13.0
下载完成后按照程序向导完成安装。

打开 CCSwitch 客户端，按以下流程完成配置：

安全提醒 **提示：**若客户端按钮文字与本文描述存在细微差异，请以 CCSwitch 实时界面为准，核心目标为绑定 GPT88 接口、密钥与模型分组。

返回终端，执行启动命令：

claude

进入 Claude Code 交互窗口后输入测试文本校验连通性：

你好

验证成功 客户端正常返回对话回复，代表整套安装与配置流程全部生效。

该现象为终端安全机制，属于正常情况，直接输入本机登录密码后回车即可。

**故障原因：**终端环境变量未刷新或安装未完成。处理方案：

claude --version

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

**故障原因：**API Key 复制不全、存在多余空格、密钥失效。处理方案：跳转令牌选择与 API 配置重新复制完整密钥，在 CCSwitch 内更新配置并重新启用。

**处理方案：**核对 CCSwitch 内填写的接口地址与「令牌选择与 API 配置」页面地址保持一致，确认当前启用配置为新建的 GPT88 专用配置。