Claude Code 是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。

Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

1 安装Claude Code

系统要求

类别	详细要求
操作系统	macOS 13.0+、Windows 10 1809+ / Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+
硬件配置	至少 4 GB RAM，配备 x64 或 ARM64 处理器
Shell 环境	Bash、Zsh、PowerShell 或 CMD
网络与位置	需要互联网连接，且位于 Anthropic 支持的国家/地区

1.1 Native Install （推荐）

Claude Code 的官方推荐安装方式是原生二进制安装。

macOS, Linux, WSL:

# 安装最新版本
curl -fsSL https://claude.ai/install.sh | bash
# 安装指定的版本
curl -fsSL https://claude.ai/install.sh | bash -s X.X.X

Windows PowerShell:
```
irm https://claude.ai/install.ps1 | iex
```

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

1.2 Homebrew

brew install --cask claude-code

1.3 npm (v2.1.15 开始被弃用)

需要先使用node --version确认安装过node.js，再执行以下命令

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

安装成功会出现如下提示信息

2 安装CC Switch

为什么需要 CC Switch？

Claude Code 默认连接的是 Anthropic 官方的 Claude 模型，但国内用户面临几个问题：

网络不通：官方 API 在国内无法直接访问
支付困难：需要外币信用卡
成本高：官方定价对国内开发者偏贵

CC Switch 的作用就是解决这些问题，它本质上是一个本地代理 + 模型切换器。

2.1 下载安装CC Switch

项目地址：Github

windows可以直接下载安装包后安装桌面程序

Linux推荐使用CC Switch CLI或使用以下安装方式

curl -o /tmp/XXXX  XXXXXX
sha256sum /tmp/XXXX
dpkg -i /tmp/XXXXX
# 验证安装
dpkg -l cc-switch
which cc-switch
# 执行时若出现提示缺少 libayatana-appindicator3-1、libwebkit2gtk-4.1-0、libgtk-3-0 等包。需要执行自动修复：
sudo apt --fix-broken install -y

2.2 下载安装CC Switch CLI (Linux)

项目地址：Github

快速安装

curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

通过 Homebrew 安装
```
brew install cc-switch-cli
```

源码构建

git clone https://github.com/saladday/cc-switch-cli.git
cd cc-switch-cli/src-tauri
cargo build --release
# Binary location: ./target/release/cc-switch
# macOS/Linux
sudo cp target/release/cc-switch /usr/local/bin/
# Windows
copy target\release\cc-switch.exe C:\Windows\System32\