Claude Code 最新版安装教程|Windows/Mac/Linux 全平台保姆级指南

本文面向普通用户,详细介绍 Claude Code 的安装与模型接入,让你快速上手这款强大的 AI 编程助手。


📋 目录

  1. 安装 Git Bash(仅 Windows)
  2. 安装 Claude Code 本体
  3. 配置环境变量 PATH
  4. 安装 cc-switch,接入更多模型
  5. Claude Code 基础使用
  6. 常见问题

1. 安装 Git Bash(仅 Windows)

Mac / Linux 用户可跳过此步骤。

Claude Code 原生为 Linux / macOS 设计,Windows 系统需要先安装 Git 来完成环境准备。

下载地址:

版本 适用场景
Git for Windows(64-bit) 绝大多数 Windows 电脑
Git for Windows(ARM64) ARM 处理器的 Windows 电脑

安装过程一路点击「下一步」即可,无需特殊配置。


2. 安装 Claude Code 本体

打开终端,粘贴对应命令即可自动安装。

Windows(PowerShell)

irm https://daheiai.com/cc.ps1 | iex

如需安装 2.1.153 稳定版本(推荐):

& ([scriptblock]::Create((irm https://daheiai.com/cc.ps1))) 2.1.153

⚠️ 2.1.156 版本使用第三方 API 存在兼容性问题,建议回退到 153 版本。

备用官方命令:

irm https://claude.ai/install.ps1 | iex

Mac / Linux(Terminal)

curl -fsSL https://claude.ai/install.sh | sh

整个过程会下载约 200MB 的安装包,具体时间取决于网络状况。


3. 配置环境变量 PATH

安装完成后,需要将 Claude Code 的可执行文件路径加入系统 PATH。

Windows 操作步骤

  1. 点击「开始菜单」,搜索 环境变量,点击「编辑系统环境变量」
  2. 在弹出窗口中点击「环境变量」按钮
  3. 在用户变量中找到 Path,双击编辑
  4. 点击「新建」,添加以下路径:
C:\Users\你的用户名\.local\bin\
  1. 依次点击「确定」保存所有更改
  2. 重新打开一个终端窗口使配置生效

Mac / Linux

通常安装脚本会自动配置,如未生效,可手动添加到 shell 配置文件:

# bash 用户
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zsh 用户
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. 安装 cc-switch,接入更多模型

Claude Code 安装完成后,还需要配置模型才能正常使用。cc-switch 是一个模型切换工具,支持接入多种 AI 模型提供商。

cc-switch 支持的模型

  • 国产模型:智谱 GLM、MiniMax、Kimi、DeepSeek 等
  • 海外模型:Claude、GPT 等(通过 API 服务接入)

下载安装

平台 下载地址
Windows CC-Switch for Windows
macOS CC-Switch for macOS

新版本可从 GitHub Releases 获取更新。

配置步骤(以智谱 GLM 为例)

  1. 打开 cc-switch 应用
  2. 选择 Claude 图标(默认第一个)
  3. 点击「添加渠道」
  4. 填入你的 API 密钥
  5. 指定 模型名称(如 glm-4
  6. 点击「启用」该渠道
  7. 回到终端,输入 claude 即可开始对话

5. Claude Code 声明

本安装脚本(cc.ps1)用于自动化安装流程,脚本已开源在 GitHub 上可公开查看。

重要说明:

  • 脚本会获取官方版本信息(latest / manifest.json),并在本地执行安装
  • 所有二进制文件(claude.exe)均由用户电脑直接从 Anthropic 官方 Google Cloud Storage 存储桶下载
  • 使用前请确认当前网络环境能正常访问 storage.googleapis.com 及相关官方地址
  • 本项目与 Anthropic, Inc.、Google LLC 均无关联、合作或授权关系
  • 使用本脚本即表示您已阅读并同意:请自行评估网络、系统与数据环境,并遵守所在地法律法规

6. 常见问题

Q1:安装命令执行后没有反应?

检查网络连接是否正常,能否访问 storage.googleapis.com。部分地区可能需要配置代理。

Q2:claude 命令提示找不到?

请确认 PATH 环境变量是否配置正确,并重新打开一个终端窗口后重试。

Q3:cc-switch 添加渠道后无法连接?

  • 检查 API 密钥是否正确
  • 确认所选模型名称与提供商一致
  • 检查网络是否可达对应 API 地址

Q4:安装过程很慢?

安装包约 200MB+,取决于网络状况。如持续卡住,可尝试切换网络或使用代理。


总结

步骤 操作 适用平台
安装 Git Bash 仅 Windows
安装 Claude Code 全平台
配置 PATH 环境变量 全平台
安装 cc-switch 并配置模型 全平台

完成以上四步后,在终端输入 claude 即可开始你的 AI 编程之旅!🚀

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐