Claude Code 终端插件系统详解：安装、配置、切换模型一手记录

从零开始，在终端里搭建你的AI法律工作台

2026年5月12日，Anthropic正式发布了Claude for Legal——一套包含12个法律插件的AI工具集，深度覆盖合同审查、诉讼管理、知识产权等法律全链条。这套插件以开源免费的方式提供给全球法律从业者，任何人都可以在自己的电脑上安装使用。

但问题来了：Claude for Legal的插件系统只运行在终端版Claude Code中，VSCode版本和桌面版本均不支持。对于没有编程基础的律师来说，"终端"两个字就足以劝退。本文是一位民商事律师的真实操作记录，从安装Node.js到配置模型、安装插件，每一步都经过实测验证，截图均来自本人Mac电脑。

如果你是无编程基础的法律从业者，跟着本文一步步操作，30分钟内即可拥有自己的AI法律工作台。

一、Claude Code是什么？和ChatGPT有什么区别？

简单理解：Claude Code是Anthropic公司推出的命令行AI工具，它直接运行在你电脑的终端里，能够读取你电脑上的文件、执行命令、编辑代码。和网页版的ChatGPT不同，Claude Code更像是一个住在你电脑里的AI助手。

对于律师而言，Claude Code的核心价值不在于写代码，而在于它的插件系统。通过安装Claude for Legal系列插件，Claude Code可以变身为专业的法律AI助手，能够审查合同、管理诉讼案件、进行专利分析等。

关键认知：Claude Code本身只是"壳"，真正让律师用起来的，是安装在里面的"插件"。就像手机本身不能拍照，需要装上相机APP才行。Claude for Legal的12个插件，就是专门为律师开发的"APP"。

二、安装前的准备工作

2.1 确认系统环境

Claude Code支持macOS、Windows和Linux系统。本文以macOS为例，Windows操作逻辑基本相同。

首先需要确认你的Mac系统版本。点击左上角苹果图标 → "关于本机"，确认系统版本为macOS 12或更高。

2.2 安装Node.js

Node.js是Claude Code的运行环境，必须先安装。

第一步：打开Node.js官网

在浏览器中访问 https://nodejs.org，你会看到两个下载按钮。选择左侧的LTS（长期支持版），这是稳定版本，适合大多数用户。右侧的Current是最新实验版，不建议选择。

第二步：下载安装包

点击LTS按钮后，浏览器会自动下载一个.pkg安装包。下载完成后，双击打开，按照安装向导一路点击"继续"即可完成安装。

备用方案：如果Node.js官网下载速度太慢，可以使用淘宝镜像站 https://npmmirror.com/mirrors/node/，在页面中找到LTS版本对应的.pkg文件下载。

第三步：验证安装

打开终端（在"启动台"中搜索"终端"或按Cmd+空格搜索"Terminal"），输入以下命令：

node -v

如果显示版本号（例如v22.x.x或v24.x.x），说明Node.js安装成功。

再输入以下命令验证npm（Node.js的包管理器）：

npm -v

同样显示版本号即表示安装完成。

2.3 获取API密钥

Claude Code需要配置一个AI模型的API密钥才能工作。对于国内用户，最实用的方案是使用DeepSeek的API，价格低廉且兼容Claude Code。

访问 https://platform.deepseek.com注册账号，在"API Keys"页面创建一个密钥，将其保存好（后面会用到）。

费用参考：DeepSeek API按token计费，日常使用成本极低。新注册用户通常有免费额度，足够体验使用。你也可以使用Anthropic官方的Claude API（需海外支付方式），或小米MiMo API（需在 https://platform.xiaomimimo.com注册）。

三、安装Claude Code

3.1 通过npm安装

在终端中输入以下命令：

npm install -g @anthropic-ai/claude-code

等待安装完成。整个过程需要下载约200MB文件，取决于网络速度，通常需要1-3分钟。

常见问题——安装报错：如果安装过程中报错，可能是因为npm的全局安装路径配置有误。可以尝试强制安装：npm install -g @anthropic-ai/claude-code --force。如果仍然失败，可能需要修复npm的prefix配置，输入 npm config set prefix ~/.local后重试。

3.2 启动Claude Code

安装完成后，在终端中输入：

claude

第一次启动时，Claude Code会显示欢迎界面并引导你完成初始配置。按照提示选择配置方式即可。

如果提示 claude: command not found，说明安装路径没有加入系统环境变量。此时需要检查npm的全局安装路径：

npm config get prefix

如果显示的路径不是 ~/.local或标准的Node.js安装路径，需要修正。输入以下命令修复：

npm config set prefix ~/.local

然后重新安装Claude Code：

npm install -g @anthropic-ai/claude-code --force

安装完成后，需要将路径加入环境变量。在终端中输入：

export PATH="$HOME/.local/bin:$PATH"

再次输入 claude即可启动。

四、配置AI模型

Claude Code支持多种AI模型。你可以使用Anthropic官方的Claude模型，也可以接入国产模型如DeepSeek、小米MiMo等。配置方法是通过修改Claude Code的配置文件。

4.1 配置文件位置

Claude Code的配置文件路径为：

~/.claude/settings.json

在终端中可以用以下命令打开编辑：

open -e ~/.claude/settings.json

如果文件不存在，可以手动创建。

4.2 配置DeepSeek模型

将配置文件内容设置为以下格式（请替换为你自己的API密钥）：

{   "env": {     "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",     "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",     "ANTHROPIC_MODEL": "deepseek-v4-pro"   } }

保存文件后，重新启动Claude Code。如果启动界面显示的模型名称为 deepseek-v4-pro，说明配置成功。

说明：DeepSeek API采用了Anthropic兼容格式，所以配置中使用的环境变量名称仍然是ANTHROPIC开头的。DeepSeek API当前支持的模型为 deepseek-v4-pro和 deepseek-v4-flash，不支持其他第三方模型名称。

4.3 配置小米MiMo模型（可选）

如果你也想使用小米的MiMo V2.5 Pro模型，需要前往 https://platform.xiaomimimo.com注册并获取API密钥。然后将配置文件中的三个字段替换为：

{   "env": {     "ANTHROPIC_BASE_URL": "https://api.xiaomimimo.com/v1",     "ANTHROPIC_AUTH_TOKEN": "你的MiMo密钥",     "ANTHROPIC_MODEL": "mimo-v2.5-pro"   } }

MiMo V2.5 Pro是小米2026年4月发布的开源模型，采用MIT协议，主打长程推理和复杂Agent任务，代码能力对标Claude Sonnet。

重要提醒：你不能在DeepSeek的API通道中使用MiMo模型，也不能在MiMo的API通道中使用DeepSeek模型。每次只能配置一个API通道。如果需要在不同模型之间切换，必须修改配置文件中的三个字段并重启Claude Code。

4.4 一键切换模型

频繁修改配置文件确实麻烦。一个实用的做法是准备多个配置文件，需要切换时直接复制覆盖：

# 切换到DeepSeek cp ~/.claude/profiles/deepseek.json ~/.claude/settings.json  # 切换到MiMo cp ~/.claude/profiles/mimo.json ~/.claude/settings.json

你也可以让AI助手（如WPS灵犀）帮你完成模型切换——告诉它"帮我切换到MiMo模型"，它会自动修改配置文件。

五、插件系统详解

Claude Code插件系统工作流程

Claude Code的插件系统（Plugin System）是其最强大的功能之一。通过插件，Claude Code可以从一个通用AI工具转变为专业领域的专家助手。

5.1 插件系统的核心概念

Claude Code的插件系统由三个核心组件构成：

插件市场（Marketplace）——类似于手机的应用商店，是插件的分发平台。Anthropic官方维护了一个市场源 anthropics/skills，目前已经收录了186个以上的插件。

插件（Plugin）——安装到Claude Code中的功能模块。每个插件针对特定领域或任务设计，包含预定义的指令和知识库。安装后，Claude Code会自动理解该领域的专业术语和工作流程。

配置文件（CLAUDE.md）——每个插件安装后会在 ~/.claude/plugins/config/目录下生成对应的配置文件。这些配置文件记录了你的个人信息、工作偏好、执业领域等，让Claude Code在执行任务时能够结合你的具体情况给出定制化建议。

5.2 插件系统的三条核心命令

整个插件系统的操作只需要记住三条命令：

第一条：添加插件市场源

/plugin marketplace add anthropics/skills

这条命令将Anthropic官方的插件市场源添加到你的Claude Code中。执行后会显示市场中有多少可用插件。

第二条：搜索和安装插件

/plugin discover

这条命令打开插件搜索界面，你可以输入关键词（如"legal"、"writing"、"data"）来查找相关插件。找到目标插件后，选中它并按回车即可安装。

第三条：重载插件

/reload-plugins

安装新插件后，必须执行这条命令才能让Claude Code识别新插件。安装完插件后立刻执行一次。

记忆口诀："添加市场源" → "搜索并安装" → "重载"。三步走，所有插件都是这个流程。

六、安装Claude for Legal插件

现在进入最关键的部分——安装法律插件。

6.1 添加Claude for Legal市场源

在Claude Code终端中输入：

/plugin marketplace add claude-for-legal/marketplace

如果提示成功添加，说明Claude for Legal的市场源已经就绪。

6.2 安装具体插件

Claude for Legal目前包含12个插件，覆盖法律行业的不同岗位。以下列出几个对律师最实用的插件：

commercial-legal——商事法律服务。适用于公司法律顾问、投融资律师，擅长合同审查、公司治理、合规咨询等场景。安装后会引导你配置律所信息（名称、辖区、执业领域等）。

litigation-legal——诉讼案件管理。适用于诉讼律师，能够协助管理案件进度、诉讼期限、财产保全、外聘律师协调等。

ip-legal——知识产权法律服务。适用于IP律师，覆盖专利、商标、著作权、商业秘密等全领域知识产权事务，支持中国CNIPA注册体系的流程管理。

安装方法：在Claude Code终端中输入插件名称即可：

/plugin install ip-legal

安装过程中，Claude Code可能会询问安装方式。选择"Install for you"（自动安装）并按回车。安装完成后，执行：

/reload-plugins

6.3 完成插件配置

每个插件安装后都需要进行一次初始配置（类似新手机的开机设置）。以ip-legal为例，安装后会自动启动一个"冷启动访谈"（cold-start-interview），问你一系列问题来了解你的执业背景：

角色选择：你是律师、专利代理师还是企业法务？

执业类型：独立执业、小型律所还是大型律所？

专业领域：专利、商标、著作权、商业秘密还是全领域？

执业辖区：你主要在哪个国家/地区的哪个城市执业？

回答完这些问题后，插件会自动生成一份配置文件（CLAUDE.md），保存在 ~/.claude/plugins/config/claude-for-legal/ip-legal/CLAUDE.md中。这份配置文件通常有100-200行，记录了你的完整执业信息。

配置文件示例：一份典型的ip-legal配置文件包含：执业身份（律师/专利代理师）、执业辖区（如中国江苏无锡）、知识产权领域覆盖范围、CNIPA专利商标系统操作规范、常用法律条文索引等。这些信息会让Claude Code在后续使用中给出符合你执业环境的专业建议。

七、日常使用方式

7.1 启动Claude Code

在终端中输入 claude即可启动。启动后你会看到一个对话界面，直接用自然语言输入你的需求即可，不需要输入任何编程命令。

例如：

帮我审查一份技术转让合同的知识产权条款，重点关注专利权属约定和侵权责任分配

Claude Code会调用已安装的ip-legal插件中的专业知识，结合你配置的执业信息，给出针对性的分析意见。

7.2 查看已安装插件

在Claude Code中输入：

/plugin list

会列出所有已安装的插件及其状态。

7.3 获取插件帮助

每个插件都内置了帮助信息。输入以下命令可以查看插件的使用说明：

/ip-legal:help

（将ip-legal替换为你想查询的插件名称）

7.4 使用场景举例

安装了legal系列插件后，你可以直接用自然语言完成以下任务：

合同审查："帮我审查这份租赁合同的违约条款是否公平"——粘贴合同文本后，Claude Code会逐条分析风险点。

法律检索："检索江苏省关于民间借贷利率上限的最新规定"——Claude Code会搜索相关法规并给出结论。

文书起草："帮我起草一份民事起诉状，原告是张某，被告是某建筑公司，案由是建设工程施工合同纠纷"——Claude Code会生成格式规范的起诉状初稿。

案件分析："分析这个商标侵权案件的胜诉可能性，原告注册了第X类商标，被告在类似商品上使用了近似标识"——Claude Code会从商标法的角度进行专业分析。

核心理解：安装了插件之后，Claude Code就是你的法律助手。你不需要学习任何编程知识，只需要像和同事聊天一样，用中文描述你的需求即可。插件会在后台自动调用相关的专业知识和工作流程。

八、常见问题排查

8.1 终端输入claude没有反应

这是最常见的问题，原因通常是npm全局安装路径没有加入系统环境变量。解决方法见本文3.2节的说明。核心步骤是执行 npm config set prefix ~/.local然后重新安装。

8.2 VSCode中无法使用插件

这是Anthropic的设计限制。Claude Code的插件系统仅支持终端版本。VSCode中的Claude Code扩展目前不支持 /plugin命令。如果你需要在VSCode中使用插件功能，可以通过VSCode的内置终端运行Claude Code。

8.3 模型配置后报400错误

如果启动Claude Code后遇到400错误，通常是API密钥或模型名称配置有误。检查以下几点：

API密钥是否正确复制，没有多余的空格。

模型名称是否是该API提供商支持的。例如，DeepSeek API只支持 deepseek-v4-pro和 deepseek-v4-flash，不能填入其他模型名称。

BASE_URL是否正确。DeepSeek的是 https://api.deepseek.com/anthropic，MiMo的是 https://api.xiaomimimo.com/v1。

8.4 安装插件时网络连接失败

插件市场源托管在GitHub上，国内网络可能需要代理才能访问。如果遇到连接超时，可以尝试配置终端代理，或使用VPN。

8.5 插件安装后Claude Code没有识别

安装插件后必须执行 /reload-plugins命令。如果重载后仍然无法识别，尝试退出Claude Code（输入 /exit）后重新启动。

九、总结

Claude Code的插件系统为法律从业者打开了一扇窗。通过简单的终端操作，你可以在自己的电脑上搭建一个功能强大的AI法律工作台。整个过程不需要编程知识，只需要耐心跟着步骤操作。

本文覆盖了从安装Node.js到配置模型、从添加市场源到安装法律插件的完整流程，每一个命令都经过实测验证。如果你在操作过程中遇到问题，建议先对照"常见问题排查"章节逐一检查，大部分问题都可以在那里找到答案。

AI不会取代律师，但会用AI的律师会取代不会用AI的律师。Claude for Legal插件系统让每一位律师都能以极低的成本享受到专业级的AI辅助，关键在于迈出第一步。

本文基于作者在Mac系统上的真实操作记录撰写
操作环境：macOS + Claude Code v2.1.141 + DeepSeek V4 Pro
发布日期：2026年5月