Claude Code 下载与使用手册
本手册介绍基本使用方法。安装命令和功能会随版本更新,请以 Claude Code 官方文档 和 Claude Code Github官方文档 为准。
教程基于Claude Code 官方文档 和 Claude Code Github官方文档 编写。
一、下载前了解
-
Claude Code 是 Anthropic 提供的 AI 辅助工具。推荐和同为 Anthropic 的 claude 模型一起使用。
-
Claude Code 有多种下载方式,这里只介绍CLI和插件这两种下载方式。Claude Code 还有App,也就是桌面版。因为步骤较为繁琐,这里不进行介绍。若各位想要安装桌面版,可以去网络上自行搜索教程。
附上 App官方下载地址,可以选择 Windows 和 macOS ,Linux版本目前还在测试阶段。如下图所示。

二、Claude Code CLI 版本安装
Claude Code 早期使用 npm 安装方式安装,现在供应商 Anthropic 推出了原生安装器,因此不需要提前安装 Node.js 。
- Windows
- macOS
- Linux
系统要求:
- Windows 10 1809+ 或 Windows Server 2019+ (所有 Windows 11 都满足)
1、安装 Git
请访问 Git - Downloads 网站,选择 Windows 对应版本安装。
2、安装 Claude Code
Win + R 输入 “cmd” 或 “powershell” 打开终端窗口并运行:
#若打开的是 CMD 终端窗口,请运行
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
#若打开的是 PowerShell 终端窗口,请运行
irm https://claude.ai/install.ps1 | iex
安装后重新打开终端,在 CC Switch 中进行配置。如何配置请看 CC Switch 配置
3、启动 Claude Code
打开终端并运行:
#如果想在特定目录里运行 Claude Code ,在启动 Claude Code 前可以运行
# CMD 终端窗口
cd /d "你的工作目录具体路径地址"
# PowerShell 终端窗口
cd 你的工作目录具体路径地址
#如果想在启动前检查一下,可以运行
claude doctor
#启动
claude
#打开历史对话记录可使用
claude -r
#或打开最近一次对话
claude -c
系统要求:
- macOS 13.0+
- macOS 14+ 若要使用 Homebrew 安装 OpenCode
1、安装 Claude Code
Command + Space 输入 “terminal” 打开终端窗口并运行:
方法一:
curl -fsSL https://claude.ai/install.sh | bash
方法二:
#使用 Homebrew 安装
#如果没有安装 Homebrew,请先运行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
#若下载失败,可能是网络问题,可以运行
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
#安装完 Homebrew 后重启终端,可以查看一下是否安装成功,运行
brew -- version
brew install --cask claude-code
#注意,这种方法不能自动更新,需要自己手动输入命令。
#官方提供了两种更新方式
#更新方式1,稳定渠道,但更新速度通常慢一周
brew upgrade claude-code
#更新方式2,直接获取最新版本
brew upgrade claude-code@latest
安装后重新打开终端,在 CC Switch 中进行配置。如何配置请看 CC Switch 配置
2、启动 Claude Code
打开终端并运行:
#如果想在特定目录里运行 Claude Code ,在启动 Claude Code 前可以运行
cd ~/你的工作目录具体路径地址
#如果想在启动前检查一下,可以运行
claude doctor
#启动
claude
#打开历史对话记录可使用
claude -r
#或打开最近一次对话
claude -c
系统要求:
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
1、安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
安装后重新打开终端,在 CC Switch 中进行配置。如何配置请看 CC Switch 配置
2、启动 Claude Code
打开终端并运行:
#如果想在特定目录里运行 Claude Code ,在启动 Claude Code 前可以运行
cd ~/你的工作目录具体路径地址
#如果想在启动前检查一下,可以运行
claude doctor
#启动
claude
#打开历史对话记录可使用
claude -r
#或打开最近一次对话
claude -c
三、Claude Code 插件版本安装
如果更习惯图形界面,可以在 VS Code 的扩展市场中搜索 Claude Code,注意是 Anthropic 官方发布者提供的,不要错下为其他的 Claude Code 了。如下图所示。

四、安全注意事项
- 不要把 API Key 写进公开代码仓库或截图。
- AI 生成的命令可能删除、覆盖或上传文件,执行前先阅读命令内容。
- 不要在包含密码、个人资料或公司机密的目录中盲目授权 AI 操作。