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

# ClaudeCode小白指引贴

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

## 优秀文章&项目

### Claude Code小白指引贴（给完全不懂cc的小白佬友写的）

[点击访问原帖](https://linux.do/t/topic/1048674)

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

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

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

### Claude Code简介

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

### 安装

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

* [https://docs.claude.com/zh-CN/docs/claude-code/overview](https://docs.claude.com/zh-CN/docs/claude-code/overview)

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

* [https://nodejs.org/en/download/](https://nodejs.org/en/download/)

### 模型与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](http://127.0.0.1:3456/))。

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

* 转换oai格式和a社格式

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

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

[https://github.com/musistudio/claude-code-router](https://github.com/musistudio/claude-code-router)

#### **CCR配置器**

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

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

* ZCF：包括cc，ccr，工作流，MCP等等

  [https://github.com/UfoMiao/zcf](https://github.com/UfoMiao/zcf)

* cc-switch

  [https://github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)

* claude-code-config-manage-gui

  [https://github.com/ronghuaxueleng/claude-code-config-manage-gui](https://github.com/ronghuaxueleng/claude-code-config-manage-gui)

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

### linux.do搜索技巧

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

一般的话，建议使用谷歌搜索（论坛自带的不太好）：

`关键词 linux.do`

### 相关帖子推荐

[https://linux.do/t/topic/803265](https://linux.do/t/topic/803265)

[https://linux.do/t/topic/914282](https://linux.do/t/topic/914282)

[https://linux.do/t/topic/847657](https://linux.do/t/topic/847657)

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

### 兼容与否回顾

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

1. 第一步（基础要求）：它是 OpenAI 格式吗？

   是，才可以

2. 第二步（核心能力）：它背后的模型支持工具调用吗？

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

3. 第三步（兼容性）：它有没有魔改API请求格式？

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

欢迎佬指正。

### 关键词

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