Claude code安装使用保姆级教程

158 阅读2分钟

Claude Code是Anthropic推出的编程AI代理工具。2026年国内开发者可通过配置ANTHROPIC_BASE_URL实现本地化接入:极速平替——用Qwen Code v0.5.0或GLM-4.7,毫秒响应,适合日常编码;满血原版——经灵芽API中转调用Claude Opus 4.5,胜任复杂架构与深度推理。

安装Claude code

Windows 平台安装教程

步骤 1:安装 Node.js

推荐方法: 访问 Node.js 官网,下载并安装 LTS (长期支持) 版本的 Windows 安装程序 (.msi)。

备用方法: 使用 winget 等包管理器进行安装。

# 使用 Winget 安装
winget install OpenJS.NodeJS.LTS

验证安装: 安装完成后,打开新的命令行窗口(CMD 或 PowerShell)并运行:

node --version
npm --version

步骤 2:安装 Claude Code CLI 以管理员身份 运行命令行窗口,执行以下命令进行全局安装:

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

安装完成,通过 claude --version 命令验证是否成功。

macOS 平台安装教程

步骤 1:安装 Node.js

推荐方法: 使用 Homebrew 进行安装。

# 如果未安装 Homebrew,请先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node

备用方法: 前往 Node.js 官网 下载 .pkg 安装包。

验证安装: node --version 和 npm --version。

步骤 2:安装 Claude Code CLI 打开终端并执行:

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

Linux 平台安装教程

步骤 1:安装 Node.js 使用您的发行版包管理器进行安装。以 Ubuntu/Debian 为例:

# 推荐使用 NodeSource 获取较新版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装: node --version 和 npm --version。

步骤 2:安装 Claude Code CLI 打开终端并执行:

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

安装CC-Switch

CC-Switch是基于Rust + Tauri框架开发的AI编程工具配置管理桌面应用,本质是「API配置切换管家」。它专为Claude Code、Codex、Gemini CLI 三大主流AI编程工具设计,核心价值在于将原本需要5分钟的手动配置流程压缩至5秒,效率提升60倍。

安装前准备

系统要求:macOS 10.15+(支持Intel芯片与Apple Silicon芯片)

依赖环境:已安装Node.js 18+(用于Claude Code CLI运行,可选但推荐)

网络环境:无需科学上网,国内网络可正常下载安装

Windows安装教程

最新v3.10.3便携版(PowerShell执行)

步骤1. 下载最新v3.10.3便携版(PowerShell执行)

Invoke-WebRequest -Uri "https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows-Portable.zip" -OutFile "$env:USERPROFILE\Downloads\CC-Switch-Portable.zip"

步骤2. 解压到桌面

Expand-Archive -Path "$env:USERPROFILE\Downloads\CC-Switch-Portable.zip" -DestinationPath "$env:USERPROFILE\Desktop\CC-Switch"

步骤3. 启动程序

Start-Process "$env:USERPROFILE\Desktop\CC-Switch\CC Switch.exe"

Mac安装

方法一:Homebrew命令安装(推荐,一键完成) 打开Mac终端,依次执行以下命令:

# 添加CC-Switch的Homebrew仓库
brew tap farion1231/ccswitch
brew install --cask cc-switch

安装完成后,可在启动台找到CC-Switch图标,直接点击启动。

方法二:手动下载安装(适合无Homebrew环境)

1.访问GitHub官方Release页面:github.com/farion1231/…

2.下拉找到Assets,下载Mac版本安装包(格式为.zip或.tar.gz,无需区分芯片类型)

3.解压安装包,将CC-Switch拖拽至「应用程序」文件夹

4.首次启动时,若提示「无法打开,因为它来自身份不明的开发者」,需进行以下设置:

打开「系统设置」→「隐私与安全性」
找到「安全性」模块,点击「仍要打开」
在弹出的确认窗口中选择「打开」,即可正常启动

中转API的使用

灵芽APIapi.lingyaai.cn/

步骤一:进入灵芽官网,注册登录并申请apikey

步骤二:打开cc-swicth,点击添加供应商,填写申请到的apikey,与访问地址,即可使用满血版的claude code。

Wow3Codeapi.wow3.top/ 使用方法与灵芽api一致