最后更新：2026年6月27日
参考官方文档：https://code.claude.com/docs/en/overview
前言
Claude Code 是 Anthropic 推出的官方命令行工具，让开发者可以直接在终端中与 Claude 大模型对话、编写代码、解决问题。
然而，由于网络限制，国内开发者无法直接访问 Anthropic API。CC Switch 是一款跨平台桌面应用，支持 50+ API 供应商一键切换，完美解决这个问题。
本文将手把手教你完成安装，30 分钟内即可开始使用。
一、Claude Code 官方安装方式
⚠️ 注意：通过 npm 安装已弃用，请使用以下推荐方法。
1.1 原生安装（推荐）
macOS / Linux / WSL：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
irm https://claude.ai/install.ps1 | iexWindows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd💡 原生安装会自动在后台更新，保持最新版本。
1.2 Homebrew 安装（macOS / Linux）
# 稳定版（推荐）
brew install --cask claude-code
# 最新版
brew install --cask claude-code@latest⚠️ Homebrew 安装不会自动更新，需手动运行
brew upgrade claude-code
1.3 WinGet 安装（Windows）
winget install Anthropic.ClaudeCode⚠️ WinGet 安装不会自动更新，需手动运行
winget upgrade Anthropic.ClaudeCode
1.4 系统要求
- Node.js 18+
1.5 验证安装
# 查看版本
claude --version
# 启动 Claude Code
cd your-project
claude首次启动会提示登录。
二、使用 CC Switch 连接大模型（国内用户推荐）
2.1 CC Switch 是什么？
CC Switch 是一款跨平台桌面应用，本质上是一个 LLM Gateway（网关），支持：
- ✅ 50+ API 供应商预设
- ✅ 一键切换不同供应商
- ✅ 自动故障转移
- ✅ 用量追踪
官方仓库：https://github.com/farion1231/cc-switch
2.2 安装 CC Switch
macOS（Homebrew）：
brew install --cask cc-switchmacOS（手动下载）：
- 访问 https://ccswitch.io
- 下载
.dmg安装包 - 双击打开，拖入 Applications 文件夹
Windows：
- 访问 https://github.com/farion1231/cc-switch/releases
- 下载
.msi安装程序
Linux：
# Arch Linux
paru -S cc-switch-bin2.3 配置 API 供应商
- 打开 CC Switch 应用
- 点击 “Add Provider”
- 填写配置：
- 名称：自定义（如 “My Claude API”）
- API Base URL：中转服务商提供的地址
- API Key：从中转服务商获取
- 点击 “Save” 保存
- 点击供应商名称 → “Enable” 启用
2.4 测试连接
# 重启终端后测试
claude输入问题测试是否正常响应。
三、其他部署方式
如果你有云服务账号，也可以使用官方支持的第三方部署：
3.1 Amazon Bedrock
# 启用 Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
# 启动
claude3.2 Google Vertex AI
# 启用 Vertex
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id
# 启动
claude3.3 Microsoft Foundry
# 启用 Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource
export ANTHROPIC_FOUNDRY_API_KEY=your-api-key
# 启动
claude3.4 自定义 LLM Gateway
如果你有自己的 API 代理服务：
# 设置 Gateway 地址
export ANTHROPIC_BASE_URL='https://your-gateway.com'
# 设置 API Key
export ANTHROPIC_API_KEY='your-api-key'
# 启动
claude💡 使用
/status命令可以验证配置是否正确。
四、常用命令速查
| 命令 | 说明 |
|---|---|
claude | 启动 Claude Code |
claude --version | 查看版本 |
/status | 查看当前配置状态 |
/model | 切换模型 |
/bug | 报告问题 |
五、常见问题
Q1：安装命令报错 syntax error near unexpected token '<'
原因： 在 PowerShell 中运行了 CMD 命令，或反之
解决：
- PowerShell 提示符显示
PS C:\ - CMD 提示符显示
C:\（没有PS） - 使用对应的命令重新运行
Q2：连接失败，提示 “Connection Refused”
原因： CC Switch 未正确启用或网络问题
解决：
- 检查 CC Switch 是否已启用供应商
- 重启终端后重试
- 检查网络连接
Q3：提示 “401 Unauthorized”
原因： API Key 无效
解决：
- 检查 API Key 是否正确复制（注意空格）
- 确认 Key 是否过期或余额不足
- 在 CC Switch 中重新配置
Q4：如何切换不同的 AI 模型？
在 Claude Code 中使用 /model 命令切换模型。
Q5：Claude Code 需要重启才能生效吗？
一般情况下，CC Switch 的配置会立即生效。如果未生效，重启终端即可。
六、总结
| 方式 | 适用场景 | 特点 |
|---|---|---|
| CC Switch | 国内用户 | 一键切换，无需配置环境变量 |
| Amazon Bedrock | AWS 用户 | 使用 AWS 账单 |
| Google Vertex AI | GCP 用户 | 使用 GCP 账单 |
| Microsoft Foundry | Azure 用户 | 使用 Azure 账单 |
| 自定义 Gateway | 有代理服务 | 灵活配置 |
相关资源
| 资源 | 链接 |
|---|---|
| Claude Code 官方文档 | https://code.claude.com/docs/en/overview |
| Claude Code GitHub | https://github.com/anthropics/claude-code |
| CC Switch 官方仓库 | https://github.com/farion1231/cc-switch |
| CC Switch 官网 | https://ccswitch.io |
| Anthropic 官网 | https://www.anthropic.com |
如有问题，欢迎在评论区留言交流！