Claude Code 全平台终极安装向导

🚨 重要说明

Claude Code 都有一定上手门槛。我只负责帮你安装配置到官方客户端能正常使用。关于"怎么写代码"、"怎么用"以及第三方客户端的配置问题，概不提供指导。教程已非常详细，若仍无法搞定，请扫描下方二维码联系我进行免费远程配置，节省彼此时间。

为什么选我？

专线直连

告别 500/422/402 错误，稳定极速

全网低价

同等服务下价格最优，性价比之选

无限制使用

不限 Key、不限设备、不限并发

无忧售后

服务问题按量退款，保障权益

官方 Token 计费说明 | 店铺在就能续期，额度永久有效

购买渠道

闲鱼担保交易，安全放心

👉 点击跳转闲鱼购买

闲鱼担保交易

安全放心，官方原版体验

扫码添加微信

售后 & 进群

售后咨询

续费服务

加入用户群

免费远程

扫描上方二维码，添加好友即可享受一对一服务。

远程协助工具推荐 (按优先级)

Windows

Mac

❌ 严禁使用 CMD (命令提示符)

CMD 是旧时代的产物，不支持现代字符集和交互，使用它会导致安装失败、乱码或功能异常。

推荐: Windows Terminal 推荐: PowerShell 7 可用: WSL / Git Bash

Git 环境检查 (必选)

Claude Code 依赖 Git 进行版本控制操作

如果您没有安装 Git，启动时会报错 requires git-bash。请先验证：

PowerShell

PS C:\> git --version

# 成功示例输出: git version 2.x.x.windows.1

未安装 Git?

请下载并安装 64位 Windows 版本

官网下载国内加速源

安装 Node.js 环境

推荐使用 LTS (长期支持) 版本

强烈推荐

方法一：NVM (版本管理)

方便切换 Node 版本，避免权限问题。

1. 下载 nvm-setup.exe 下载加速版

# 安装 LTS 版本

nvm install lts

nvm use lts

方法二：官网直装

简单直接，适合不常切换环境的用户。

前往 Nodejs.org 下载

请下载 v18.x 或更高版本的 .msi 安装包

验证 Node 安装

PS C:\> node -v

v20.11.0

安装 Claude Code

通过 NPM 全局安装

PowerShell

# 标准安装命令

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

# 备用：国内镜像源安装（如果上方命令卡住）

PS>npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

💡 提示：如果安装报错，请右键开始菜单，选择“终端(管理员)”重新运行。

配置环境变量 (核心步骤)

连接中转服务的关键

权限提示

为了系统稳定性，建议设置**系统级环境变量**（Machine Level），这需要**管理员权限**运行 PowerShell。

Administrator: PowerShell

# 1. 设置 Base URL (系统级) [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cc.mcxhm.cn/api", [System.EnvironmentVariableTarget]::Machine) # 2. 设置 Token (请务必替换 '你的API密钥') [System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::Machine) # 3. 性能优化配置 (超时与非必要流量) [System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "3000000", [System.EnvironmentVariableTarget]::Machine) [System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::Machine)

如果不方便使用管理员权限，可将 Machine 改为 User 设置用户级变量。

验证环境变量

注意：设置完成后，必须**关闭并重新打开**终端窗口才能生效。

PS> Get-ChildItem Env:ANTHROPIC_*

Name Value
---- -----
ANTHROPIC_BASE_URL https://cc.mcxhm.cn/api
ANTHROPIC_AUTH_TOKEN cr_xxxxxxxx...

推荐：cc-Switch 全能配置管理工具

cc-Switch 是一个功能强大的 Claude Code / Codex / Gemini CLI 全方位辅助工具，提供供应商管理、MCP 服务器管理、Skills 管理、Prompts 管理等完整功能。一键切换多个 API 配置，无需手动修改环境变量。

🎯 核心功能：

✓ 供应商管理 - 一键切换 Claude Code、Codex、Gemini 的 API 配置

✓ MCP 服务器管理 - 统一管理三个应用的 MCP 服务器

✓ Skills 管理 - 从 GitHub 自动扫描和安装 Claude Skills

✓ Prompts 管理 - 创建和切换多个系统提示词预设

✓ 速度测试 - 测量 API 端点延迟，可视化连接质量

✓ 导入导出 - 备份和恢复配置，自动轮换保留最近 10 个

✓ 云同步 - 支持 Dropbox、OneDrive、iCloud 等云存储同步

✓ 系统托盘 - 快速切换供应商，单实例守护

🚀 最新版本特性 (v3.8.0+)：

SQLite + JSON 双层架构，为云同步奠定基础
全新用户界面，统一的组件样式和流畅动画
日语支持（中文/英文/日语）
开机自启功能
Skills 递归扫描，支持多层目录结构
Gemini CLI 完整集成
环境变量冲突检测

查看 GitHub 项目下载最新版本

GitHub 项目：farion1231/cc-switch | 下载

高级配置 (VSCode / Droid / Gemini)

VSCode 插件配置

文件路径: C:\Users\你的用户名\.claude\config.json

{ "primaryApiKey": "crs" }

Droid CLI 配置

文件路径: C:\Users\你的用户名\.factory\config.json

{ "custom_models": [ { "model_display_name": "Sonnet 4.5 [crs]", "model": "claude-sonnet-4-5-20250929", "base_url": "https://cc.mcxhm.cn/droid/claude", "api_key": "你的API密钥", "provider": "anthropic" } ] }

安装 Node.js 环境

macOS 开发环境基础

Cmd + Space 打开终端

方法一：Homebrew (强烈推荐)

BEST CHOICE

Terminal — -zsh

➜ ~ brew install node

方法二：NVM (版本管理)

GitHub 原源安装

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

source ~/.zshrc

nvm install --lts

🇨🇳 大陆加速源

export NVM_SOURCE=https://gitee.com/mirrors/nvm.git

curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash

安装 Claude Code

全局 CLI 工具

npm install

# 标准安装

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

# 国内镜像（如果下载慢）

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如遇 EACCES 权限错误，请在命令前加 sudo

验证: claude --version

配置环境变量

写入 Shell 配置文件 (.zshrc)

预清理 (防止配置冲突)

Zsh (macOS 默认)

sed -i '' '/ANTHROPIC_/d' ~/.zshrc && source ~/.zshrc

Bash (旧版)

sed -i '' '/ANTHROPIC_/d' ~/.bashrc && source ~/.bashrc

写入新配置 (永久生效)

~/.zshrc setup

# 1. 设置 API 加速地址

echo 'export ANTHROPIC_BASE_URL="https://cc.mcxhm.cn/api"' >> ~/.zshrc

# 2. 设置 Auth Token (请替换为您的 Key)

echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc

# 3. 设置超时时间 (50分钟) 与流量优化

echo 'export API_TIMEOUT_MS="3000000"' >> ~/.zshrc

echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.zshrc

# 4. 使配置立即生效

source ~/.zshrc

* Bash 用户请将 .zshrc 替换为 .bashrc

验证: echo $ANTHROPIC_BASE_URL -> 应输出 https://cc.mcxhm.cn/api

推荐：cc-Switch 快速切换工具

cc-Switch 是一个强大的环境变量快速切换工具，可以轻松管理多个 API Key 和配置，无需每次都手动修改环境变量。

✓ 快速切换 - 一键切换不同的 API 配置

✓ 配置管理 - 保存多个配置文件，随时调用

✓ 简化操作 - 无需手动设置环境变量

查看 GitHub 项目下载最新版本

高级配置 (VSCode / Droid / Gemini)

VSCode

# ~/.claude/config.json
{ "primaryApiKey": "crs" }

Droid CLI

# ~/.factory/config.json
{ "custom_models": [...] }

安装 Node.js 环境

根据发行版选择安装命令

Ubuntu / Debian

# 设置源并安装

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt-get install -y nodejs

CentOS / RHEL / Fedora

# RHEL 8+ / Fedora

sudo dnf install nodejs npm

# 旧版 CentOS 7

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

安装 Claude Code

需要 Root 权限

Bash

# 使用 sudo 进行全局安装

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

# 验证版本

claude --version

提示：如果是在 WSL2 中使用，请确保能够正常访问外网，否则请配置 npm 代理或使用镜像源。

配置环境变量

修改 .bashrc 文件

~/.bashrc setup

# 1. 写入配置到 .bashrc

echo 'export ANTHROPIC_BASE_URL="https://cc.mcxhm.cn/api"' >> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc

echo 'export API_TIMEOUT_MS="3000000"' >> ~/.bashrc

echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.bashrc

# 2. 使配置生效

source ~/.bashrc

推荐：cc-Switch 快速切换工具

cc-Switch 是一个强大的环境变量快速切换工具，可以轻松管理多个 API Key 和配置，无需每次都手动修改环境变量。

✓ 快速切换 - 一键切换不同的 API 配置

✓ 配置管理 - 保存多个配置文件，随时调用

✓ 简化操作 - 无需手动设置环境变量

查看 GitHub 项目下载最新版本

高级配置 (VSCode / Droid)

Linux 下的高级配置路径与 macOS 完全一致，请直接参考 macOS 选项卡中的路径（例如 ~/.claude/config.json）。

开始使用

所有配置已就绪！进入您的项目目录即可启动。

cd ~/projects/my-awesome-app

claude _

必备插件

ccstatusline

Claude Code 高度可定制的状态行格式化工具

ESSENTIAL

ccstatusline 是一个高度可定制的状态行格式化工具，可以在 Claude Code 运行时显示模型信息、Git 分支、Token 使用情况、会话时长、区块计时器等多种指标。帮助你精确监控 API 成本，防止超额使用。

✨ 核心特性：

✓ 实时监控 - 显示 Token 使用、会话成本、区块计时器等

✓ 高度定制 - 完全自定义显示内容和颜色

✓ Powerline 支持 - 美观的 Powerline 风格渲染

✓ 多行支持 - 配置多个独立的状态行

✓ 跨平台 - Windows、macOS、Linux 完全兼容

✓ 零配置 - 开箱即用的合理默认值

📊 可显示的指标： 模型名称、Git 分支、Git 变更、会话时长、会话成本、区块计时器、当前工作目录、Token 使用量、上下文百分比、自定义文本等

查看 GitHub 项目 NPM 下载

GitHub 项目：sirmalloc/ccstatusline | NPM

API Key 余额查询

💳

cc.mcxhm.cn

API Key 余额查询

快速查询你的 API Key 余额和使用情况，实时了解账户状态。

查询余额

🔗

快速链接

常用工具和资源

→ API 余额查询 → cc-Switch 项目 → ccstatusline 项目

💡 提示： 定期检查你的 API Key 余额，确保账户有足够的额度。使用 ccstatusline 可以实时监控会话成本。