Skip to content

Vibe Coding - 优秀文章&项目部分

优秀文章&项目

Claude Code小白指引贴(给完全不懂cc的小白佬友写的)

点击访问原帖

我自己也是一个小白,因为不是相关专业的,只是平时爱好奴役AI撸码为乐。后来看大佬的发帖用上了cc和ccr,发现这Claude Code真的顶,比一些插件体验要好不少。

然后我就发现L站关于cc的帖子比较零散,有的可能已经过时(比如没有使用ccr)。接触cc比较晚的小白的话肯定看现在cc配置的帖子很懵逼(比如我朋友),不知道大家在说啥,也不好意思问,问来问去也比较麻烦。

所以我就写了这个小白贴,主要是引导和集中教程吧,没有什么很高见的地方,如果有错误欢迎佬友指出。

Claude Code简介

一款AI编程终端工具,就像IDE里面的插件一样可以代理编码,目前来看比起其它同类型的终端工具如gemini cli似乎要强很多。

安装

基础安装教程请看官方文档

参考其中的命令可以完成安装,注意先安装node.js18或更新版本

模型与CC原理

如果你有claude账号那么可以买他们服务使用,但是我们小白肯定是没有的

所以必须使用第三方的国内官方或者公益站的AI如GLM,那么这里要解释一下,为什么第三方的AI可以这样使用,有没有条件?那么我从以下几个方面展开

大模型的工具调用

现在大模型除了聊天以外,还会工具调用

  • 以前的模型:不会工具调用,你给我文本我回复你文本,你说去给我读文件,执行读文件命令。它回复你“读文件的意义,性质,结果”,或者什么别的东西。

  • 现在的模型:会工具调用,你给我一个读文件的命令,我懂了,马上返回你一个json格式的文本作为命令

     {
       "tool_to_call": "Read",
       "parameters": {
         "file_path": "./config.js"
       }
     }

    所以并不是大模型动手了,而是懂得什么时候该生成普通文本,什么时候该生成命令文本。

    生成了命令文本之后(比如搜天气),程序(比如chatgpt的网站后端)扫描到了指令,马上启动脚本去抓取天气数据,然后返回给模型,然后模型再给你文本结果。

这些能力是用海量的指令和json回复训练的,不是简单提示词就可以学会的,因为比较笨的模型即使可以输出,但是命中率不能百分之百

cc原理

CC 的本质就是一个在终端里运行的、高度智能化的 API 客户端。

比如说你发一个重构这个项目的前端

那么这个时候cc就会向你接入的模型公司服务器发API请求,比如出生A社,发的内容是

  • 系统提示词:用来指导模型的,“你是一个编程助手,你可以使用Read(filePath),Write(filePath, content)…等工具…使用格式化的json命令回复…”

  • 项目上下文:就是你的项目代码和结构目录,比如CLAUDE.md和一些智能搜索选取的文件

  • 聊天历史、用户命令:重构这个项目的前端

这个时候发到了他们服务器里面,模型就解析了这些东西,然后回复一个json命令,然后cc接受到了这个命令,比如Read(filePath),它就启动脚本去读文件,把文件内容打包。

cc兼容请求

cc作为一个客户端,它只会发A社兼容的API请求,包括

  • API规范

  • 模型名称

如果你直接接那些普通的端点,就会不兼容。这个知识点很简单了。

模型和端点兼容

所以能不能用CC,就两点

  • 格式兼容(A社格式)

  • 模型得劲

第三方配置

那么思路就是把格式兼容的问题解决,比如搭建一个中转站转换格式,然后去配置CC文件,比如很多公益站就是兼容oai和a社的格式的,为了兼容cc。

但是我们小白个人用肯定没法就是建立中转并且改配置文件(可以但是很麻烦),所以我们要用 CCR 这个工具来转换格式。而要让 CCR 知道怎么转、往哪里转,我们就需要去配置 CCR,告诉它第三方网址端点是什么。

CCR

CCR是一个转换格式的路由器程序,安装完然后运行ccr code就会启动服务,然后CC 被设置为把 CCR 当作它的唯一对话目标,settings.json 里写的 ANTHROPIC_BASE_URL 是 CCR 的地址 (http://127.0.0.1:3456)。

这个程序会一直运行一直转你发给cc的请求,并且接受模型发来的响应转给cc。它还会

  • 转换oai格式和a社格式

  • 提供多个路由选择,你可以填很多个模型和网站,在不同场景下让它路由到不同模型

这个是一定要安装的。安装完了就配置API即可。

https://github.com/musistudio/claude-code-router

CCR配置器

CCR本身有配置方法,比如改setting.json文件,和UI管理:命令行输入ccr ui即可

不过如果你想用第三方的管理器也是可以的,更符合自己的体质(好像都是佬友开发的)

目前看cc-switch最受欢迎了,小而美的感觉,小白建议用这个。

linux.do搜索技巧

如果还有相关cc的问题,咱L站基本上是都有解决方案的,找到帖子发AI看,基本上都能解决的。

一般的话,建议使用谷歌搜索(论坛自带的不太好):

关键词 linux.do

相关帖子推荐

https://linux.do/t/topic/803265

https://linux.do/t/topic/914282

https://linux.do/t/topic/847657

https://linux.do/t/topic/920586 (二级)

兼容与否回顾

判断一个第三方咱能不能用ccr用,必须看

  1. 第一步(基础要求):它是 OpenAI 格式吗?

    是,才可以

  2. 第二步(核心能力):它背后的模型支持工具调用吗?

    最好是原生支持,次之是模拟支持。(比如 Toolify 接口),可以用,但效果可能打折扣。如果完全不支持,那就只能当个纯聊天工具用,CC 的核心功能(文件操作等)会全部失效。

  3. 第三步(兼容性):它有没有魔改API请求格式?

    如果一个公益站完全遵循标准 OpenAI 格式,那 CCR 的通用 openai 转换器就足够了。如果加了什么别的请求头什么的就不行了。

欢迎佬指正。

关键词

加一些关键词以便于检索: Claude Code 小白入门 CCR 第三方 API 工具调用