> ## Documentation Index
> Fetch the complete documentation index at: https://docs.42plugin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 一键安装脚本

> 一条命令安装 Claude Code、42plugin 等全套工具

还在为配置开发环境头疼？一条命令，1-3 分钟，全套工具自动装好。

## 2.0 版亮点

<CardGroup cols={2}>
  <Card title="更快速" icon="bolt">
    CDN 全球分发网络，国内外用户极速下载
  </Card>

  <Card title="更简单" icon="cube">
    零依赖安装，纯二进制分发，无需 Node.js / Python
  </Card>

  <Card title="更安全" icon="shield-check">
    官方构建流水线，SHA-256 完整性校验
  </Card>

  <Card title="更易用" icon="hand-pointer">
    新手友好交互界面，一键安装、升级、卸载
  </Card>
</CardGroup>

## 安装内容

脚本会自动安装：

| 组件              | 说明      |
| --------------- | ------- |
| **Claude Code** | AI 编程助手 |
| **42plugin**    | 插件管理器   |
| **42cc**        | 图形化配置工具 |
| **Zed**         | 代码编辑器   |

预计安装时间 1-3 分钟，所需磁盘空间约 300MB。

## 开始安装

<Tabs>
  <Tab title="macOS / Linux">
    打开终端（按 `Command + 空格`，输入"终端"，回车），粘贴以下命令：

    ```bash theme={null}
    curl -fsSL https://get.42plugin.com/mac | bash
    ```
  </Tab>

  <Tab title="Windows">
    以**管理员身份**打开 PowerShell（按 `Win + X`，选择"终端(管理员)"），运行：

    ```powershell theme={null}
    irm https://get.42plugin.com/win | iex
    ```

    <Warning>
      必须使用 PowerShell，CMD（命令提示符）无法运行安装命令。
    </Warning>
  </Tab>
</Tabs>

安装成功后会显示：

```
🎉 恭喜！安装完成！
```

## 安装后：刷新终端

<Warning>
  **重要**：安装完成后，必须关闭当前终端，打开**新的**终端窗口，再继续下面的步骤。
</Warning>

验证安装：

```bash theme={null}
claude --version
```

如果显示版本号（如 `2.1.71`），说明安装成功。

**如果提示 command not found：**

* 完全关闭终端应用，重新打开
* 或运行：`source ~/.zshrc`（bash 用户用 `source ~/.bashrc`）

## 只安装单个工具

不需要全套？可以用快捷命令单独安装：

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    # 只安装 Claude Code
    curl -fsSL https://get.42plugin.com/cc | bash

    # 只安装 42plugin CLI
    curl -fsSL https://get.42plugin.com/cli | bash

    # 只安装 42cc 配置工具
    curl -fsSL https://get.42plugin.com/42cc | bash

    # 只安装 Zed 编辑器
    curl -fsSL https://get.42plugin.com/zed | bash
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    # 只安装 Claude Code
    irm https://get.42plugin.com/cc.ps1 | iex

    # 只安装 42plugin CLI
    irm https://get.42plugin.com/cli.ps1 | iex

    # 只安装 42cc 配置工具
    irm https://get.42plugin.com/42cc.ps1 | iex

    # 只安装 Zed 编辑器
    irm https://get.42plugin.com/zed.ps1 | iex
    ```
  </Tab>
</Tabs>

## 配置 Claude Code

根据你的所在地区，选择合适的方式：

<Tabs>
  <Tab title="大陆用户">
    **MiniMax（推荐）**

    1. 访问 [MiniMax 开放平台](https://platform.minimaxi.com/)
    2. 注册并创建 API Key
    3. 详细教程：[MiniMax Claude Code 配置指南](https://platform.minimaxi.com/docs/guides/text-ai-coding-tools)

    **智谱 AI**

    1. 访问 [智谱 AI 开放平台](https://open.bigmodel.cn/)
    2. 注册并创建 API Key
    3. 详细教程：[智谱 Claude Code 配置指南](https://docs.bigmodel.cn/cn/coding-plan/tool/claude)
  </Tab>

  <Tab title="海外用户">
    **Claude Pro/Max 订阅（推荐）**

    1. 访问 [claude.ai](https://claude.ai/)
    2. 订阅 Claude Pro（\$20/月）或 Claude Max
    3. 运行 `claude login`，选择通过浏览器登录

    **Anthropic API（按量付费）**

    1. 访问 [Anthropic Console](https://console.anthropic.com/)
    2. 注册并创建 API Key
  </Tab>
</Tabs>

<Tip>
  如果安装了 42cc（macOS），可运行 `open -a 42cc` 在图形界面中配置。
</Tip>

## 升级

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    # 升级全部已安装的组件
    curl -fsSL https://get.42plugin.com/mac | bash -s -- --upgrade

    # 只升级 Claude Code
    curl -fsSL https://get.42plugin.com/cc | bash -s -- --upgrade

    # 只升级 42plugin
    curl -fsSL https://get.42plugin.com/cli | bash -s -- --upgrade
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    # 升级全部已安装的组件
    & ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade

    # 只升级 Claude Code
    & ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only claude-code -Upgrade

    # 只升级 42plugin
    & ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only 42plugin -Upgrade
    ```
  </Tab>
</Tabs>

<Note>
  升级模式只会更新已安装的组件，不会意外安装新组件。如果所有组件都已是最新版本，脚本会提示「已是最新」。
</Note>

## 卸载

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    # 卸载全部组件
    curl -fsSL https://get.42plugin.com/mac | bash -s -- --uninstall

    # 只卸载 Claude Code
    curl -fsSL https://get.42plugin.com/cc | bash -s -- --uninstall

    # 只卸载 42cc
    curl -fsSL https://get.42plugin.com/42cc | bash -s -- --uninstall
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    # 卸载全部组件
    & ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Uninstall

    # 只卸载 Claude Code
    & ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only claude-code -Uninstall

    # 只卸载 42cc
    & ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only 42cc -Uninstall
    ```
  </Tab>
</Tabs>

卸载后配置文件（`~/.claude/`）会保留，如需彻底删除：

```bash theme={null}
rm -rf ~/.claude
```

## 快捷命令一览

<Tabs>
  <Tab title="macOS / Linux">
    | 操作              | 命令                                                                  |
    | --------------- | ------------------------------------------------------------------- |
    | **全套安装**（推荐）    | `curl -fsSL https://get.42plugin.com/mac \| bash`                   |
    | 只装 Claude Code  | `curl -fsSL https://get.42plugin.com/cc \| bash`                    |
    | 只装 42plugin CLI | `curl -fsSL https://get.42plugin.com/cli \| bash`                   |
    | 只装 42cc         | `curl -fsSL https://get.42plugin.com/42cc \| bash`                  |
    | 只装 Zed 编辑器      | `curl -fsSL https://get.42plugin.com/zed \| bash`                   |
    | **升级全部**        | `curl -fsSL https://get.42plugin.com/mac \| bash -s -- --upgrade`   |
    | 升级单个            | `curl -fsSL https://get.42plugin.com/cc \| bash -s -- --upgrade`    |
    | **卸载全部**        | `curl -fsSL https://get.42plugin.com/mac \| bash -s -- --uninstall` |
    | 卸载单个            | `curl -fsSL https://get.42plugin.com/cc \| bash -s -- --uninstall`  |
  </Tab>

  <Tab title="Windows">
    | 操作              | 命令                                                                         |
    | --------------- | -------------------------------------------------------------------------- |
    | **全套安装**（推荐）    | `irm https://get.42plugin.com/win \| iex`                                  |
    | 只装 Claude Code  | `irm https://get.42plugin.com/cc.ps1 \| iex`                               |
    | 只装 42plugin CLI | `irm https://get.42plugin.com/cli.ps1 \| iex`                              |
    | 只装 42cc         | `irm https://get.42plugin.com/42cc.ps1 \| iex`                             |
    | 只装 Zed 编辑器      | `irm https://get.42plugin.com/zed.ps1 \| iex`                              |
    | **升级全部**        | `& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade`   |
    | 升级单个            | `& ([scriptblock]::Create((irm .../win))) -Only claude-code -Upgrade`      |
    | **卸载全部**        | `& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Uninstall` |
    | 卸载单个            | `& ([scriptblock]::Create((irm .../win))) -Only claude-code -Uninstall`    |
  </Tab>
</Tabs>

## 高级选项

| 参数                   | 说明            |
| -------------------- | ------------- |
| `--only <组件>`        | 只安装指定组件（逗号分隔） |
| `--skip <组件>`        | 跳过指定组件        |
| `-y, --yes`          | 跳过所有确认提示      |
| `--dry-run`          | 预览模式          |
| `--upgrade`          | 升级已安装的组件到最新版本 |
| `--uninstall`        | 卸载所有组件        |
| `-t, --troubleshoot` | 显示故障排除指南      |

可用组件名：`claude-code`、`42plugin`、`42cc`、`zed`

## 常见问题

<AccordionGroup>
  <Accordion title="安装卡住不动 / 下载很慢">
    按 `Ctrl + C` 中断后重新运行安装命令即可。脚本使用 CDN 加速分发，重试通常即可恢复。
  </Accordion>

  <Accordion title="macOS 提示 curl: command not found">
    运行 `xcode-select --install`，在弹出窗口中点击「安装」，等待完成后重试。
  </Accordion>

  <Accordion title="Windows 提示「禁止运行脚本」">
    以管理员身份运行 PowerShell，先执行：

    ```powershell theme={null}
    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
    ```

    输入 `Y` 确认，然后重新运行安装命令。
  </Accordion>

  <Accordion title="安装后命令找不到（command not found）">
    关闭终端并重新打开一个新窗口。macOS/Linux 也可执行 `source ~/.zshrc` 或 `source ~/.bashrc` 立即生效。
  </Accordion>

  <Accordion title="如何升级到最新版本？">
    macOS/Linux：`curl -fsSL https://get.42plugin.com/mac | bash -s -- --upgrade`

    Windows：`& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade`

    也可以只升级单个组件，如 `curl -fsSL https://get.42plugin.com/cc | bash -s -- --upgrade`。
  </Accordion>

  <Accordion title="如何卸载？">
    macOS/Linux：`curl -fsSL https://get.42plugin.com/mac | bash -s -- --uninstall`

    Windows：`& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Uninstall`

    支持单组件卸载，如 `curl -fsSL https://get.42plugin.com/cc | bash -s -- --uninstall`。
  </Accordion>
</AccordionGroup>

***

遇到问题？访问 [42ailab/42plugin/meta](https://cnb.cool/42ailab/42plugin/meta) 提交 issue。