【Claude_Code_CLI安装】代理配置-本地模型-插件生态

1134 字
6 分钟
【Claude_Code_CLI安装】代理配置-本地模型-插件生态

1 前言#

最近在使用Claude Code (简称 cc )帮助我进行日常学习、项目开发,本文记录下 Claude Code CLI 的安装、DeepSeek 模型配置、llama.cpp 本地模型内网穿透后进行公网连接的操作,最后简单提及下 skill、plugin 等功能的安装,后续也会更新下 cc 的一些进阶操作。


2 安装#

先安装 GitNode.js

Terminal window
# 国内用户(winget 源)
winget install Anthropic.ClaudeCode
# 官方渠道(npm 全局安装)
npm install -g @anthropic-ai/claude-code

安装完成后,在终端输入 claude 即可启动。


3 cc switch 多模型配置切换#

下载:CC Switch

cc switch 用于在多个模型配置之间快速切换,并对齐模型所需格式。

4 配置 DeepSeek 兼容端点#

Claude Code 默认走 Anthropic 官方 API,但也可以通过自定义端点接入 DeepSeek 等兼容模型,降低成本。

4.1 获取 API Key#

前往 DeepSeek 开放平台 申请 API Key,然后在 Claude Code 中配置。

4.2 配置自定义端点#

使用 cc switch 创建一套新配置,填入 DeepSeek 的 API 地址和 Key 即可。

注意:DeepSeek 兼容的是 OpenAI API 格式,Claude Code 内部已做适配,直接使用社区提供的端点地址即可。

点击获取模型列表,再点击一键设置即可 记得勾选1M,表示可以使用1百万token上下文,当然前提是你的模型支持(比如deepseek)


5 接入本地模型(llama.cpp)#

llama.cpp 默认提供的是 OpenAI 兼容 API,而 Claude Code 走的是 Anthropic 协议。直接在 settings.json 里填 llama.cpp 的地址是不行的,需要配合 cc switch 的自定义端点功能来桥接。

5.1 内网穿透(ngrok)#

使用 ngrok 进行内网穿透,下载客户端即可使用

如果 llama.cpp 跑在本地,想让外网也能访问(比如在另一台机器上用 Claude Code),可以用 ngrok 做内网穿透,把本地端口暴露到公网:

Terminal window
ngrok http 8080

5.2 在 Claude Code 中连接 llama.cpp#

配置步骤如下:

  1. 如果 llama.cpp 没有配置 API Keycc switch 处的 API Key 可以随意填写,不会校验。
  2. 输入请求地址后,点击管理与测速,测试是否连通。
  3. 点击高级选项展开。
  4. 点击获取模型列表(上方弹窗会显示获取到的模型数量)。
  5. 在模型下拉列表中选择你的模型。
  6. 点击一键设置
  7. 保存配置。

注意:请保持 API 格式认证字段不变,不要随意修改。

配置完成后,在任意文件夹打开终端输入 claude,测试是否正常启用。

5.3 切换模型#

cc switch 界面中,你可以随时在不同配置之间切换——远程大模型干活,本地小模型摸鱼,灵活选择。

5.4 缺点#

存在这样一种情景,我需要同时使用多家大模型,但是ccswitch只能选择启用一个供应商。

而且由于目前deepseek v4仅为文本推理llm,不具备图片理解能力,导致我必须额外配置一个具有视觉的大模型,此时我就必须使用python自己写一个网关脚本,用于对齐agent要求的格式并连接上我视觉模型,当然我们可以将其配置成全局skill,当需要视觉理解时进行调用。

5.5 CC switch实际修改配置#

cc switch实际就是建立网关,将baseurl改成自己的端口,再填写供应商的api调用地址和映射模型进行模型调用


6 Skill、Plugin、Agent 扩展#

Claude Code 的真正威力在于可扩展生态。通过插件市场,你可以安装社区提供的 Skill、Plugin 和 Agent,极大扩展能力边界。

6.1 添加市场#

首先添加 Anthropic 官方市场:

/plugin marketplace add anthropics/skills

市场地址:https://github.com/anthropics/skills

6.2 浏览与安装#

添加市场后,输入 /plugin 即可浏览所有可用插件。按需安装,最后执行一次插件重载/reload-plugin即可生效。

安装完成后,右下角状态栏会显示各服务的可用状态。如果某个 MCP 服务启动失败或需要官方验证,也会有相应提示,方便排查。


7 小结#

场景方案
安装使用官方地址 或winget安装
模型接入DeepSeek + cc switch
本地模型llama.cpp 本地模型 + cc switch
扩展能力Marketplace 安装 Skill / Plugin

折腾一圈下来,Claude Code CLI 就配置好了—— 一套工具,多种后端模型,按需切换。希望这篇笔记能帮你少走弯路。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!

赞助
【Claude_Code_CLI安装】代理配置-本地模型-插件生态
https://hp-patience.github.io/posts/claude-code-cli-setup/
作者
Celyn
发布于
2026-05-23
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
Profile Image of the Author
Celyn
费曼学习法,反思近期所学并反馈输出,将所学知识内化。
公告
欢迎来到 Celyn 的博客!专注于AI大模型、深度学习与编程技术分享。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
23
分类
9
标签
22
总字数
29,378
运行时长
0
最后活动
0 天前

文章目录