# Claude Code 安装教程：macOS、Windows 与 VS Code 扩展

> 在 macOS 和 Windows 安装 Claude Code CLI，或选择官方 VS Code 扩展；安装后用 Passion8 地址、API Key 和可用模型完成配置与验证。

URL: https://docs.passion8.cc/docs/claude-code/install
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

Claude Code 可以用在终端、桌面端和 IDE 里。**使用 Passion8 的本地接入顺序是：安装 → 填写本站地址、API Key 和可用模型 → 重启 → 验证请求**，无需厂商 OAuth 登录。下面保留各入口的安装步骤；如果主要在编辑器里开发，可以直接看 [Claude Code 官方 VS Code 扩展配置](https://docs.passion8.cc/docs/claude-code/vscode)。

安装 CLI 后继续看 [配置 Claude Code](https://docs.passion8.cc/docs/claude-code/settings)；完整 CLI 命令、PATH 和终端快捷键见 [CLI 与终端参考](https://docs.passion8.cc/docs/claude-code/cli-terminal-reference)。

## 安装 CLI






### macOS


```bash
curl -fsSL https://claude.ai/install.sh | bash
exec $SHELL -l
claude --version
```





### Windows


用 PowerShell 运行:

```powershell
irm https://claude.ai/install.ps1 | iex
claude --version
```











`claude` 命令找不到时,先关闭并重新打开终端。仍不生效,就按安装脚本的输出把 Claude Code 目录加入 `PATH`,再运行 `claude --version`。




## 安装桌面端

从官方入口下载对应系统版本,按安装器提示完成后打开,确认能选择或打开本地项目。

[打开 Claude Code 官方安装入口](https://docs.anthropic.com/en/docs/claude-code/setup)

## 安装官方 IDE 插件

1. 在 IDE 的插件市场搜索 `Claude Code`。
2. 选择 Anthropic 官方发布的插件安装。
3. 重启 IDE,打开一个项目,确认 Claude Code 面板或命令可用。




官方 VS Code 扩展内置对话面板所需的 Claude Code，无需先安装独立 CLI。若要在集成终端运行 `claude` 命令，仍需安装 CLI 并确保 `PATH` 正确。扩展的用户设置和认证步骤见 [VS Code 配置教程](https://docs.passion8.cc/docs/claude-code/vscode)。




## 验证安装

进入任意项目目录运行:

```bash
claude --version
```

看到版本号说明 CLI 安装成功。先完成 [Passion8 配置](https://docs.passion8.cc/docs/claude-code/settings)，重新打开终端，再在项目目录运行 `claude` 或教程中的测试请求。配置前出现登录提示不代表需要注册厂商账号；按 API Key 接入流程完成配置即可。

## 排错

遇到 `claude` 命令、PATH、权限、代理、TLS、Windows/WSL 或登录异常,看 [安装与登录排错](https://docs.passion8.cc/docs/claude-code/install-troubleshooting)。

## 官方参考

- [Quickstart](https://code.claude.com/docs/en/quickstart.md)
- [Setup](https://code.claude.com/docs/en/setup.md)
- [Troubleshoot installation](https://code.claude.com/docs/en/troubleshoot-install.md)

## 下一步



- [配置 Claude Code](https://docs.passion8.cc/docs/claude-code/settings): 用手动配置或 CC-Switch 接入 Passion8。
- [命令与交互](https://docs.passion8.cc/docs/claude-code/commands): 常用命令、斜杠命令与会话操作。
- [安装与登录排错](https://docs.passion8.cc/docs/claude-code/install-troubleshooting): 排查 PATH、冲突安装、权限、网络代理、TLS、Windows/WSL 和 OAuth。