《给小白的 Claude Code 配置操作指南》
# 关于 Claude Code
既然你看到了这篇文章,那我想你一定已经对 Claude Code 有所了解,无论是否上手试用过,都一定在 AI 博主和 AI 文章中,多次看到 Claude Code 的身影。
Claude Code 是一个由 AI 驱动的代理编码工具,可以读取你的代码库、编辑文件、运行命令,然后帮助你构建功能、修复错误和自动化工作,能理解你的整个代码库和文件库,可以跨多个文件和工具工作以完成任务。
但实际上,Claude Code 不仅仅是开发者的工具,它也可以通过对于文件的处理,成为办公助手。Claude Code 本质上是一个 Agent,你可以操作它进行各种电脑上的动作,比如"把 A 文件夹的文件批量重命名并移动到 B 文件夹",或者"根据 A 文件夹中 Excel 的财务流水数据,产出本年度财务分析报告,以 Markdown 格式输出"。
总之,由于 Claude Code 是 AI 驱动的,因此,借助 AI 可以进行的各种能力,都能够很好实现。相较于网页版的 Chat 对话型 AI ,Claude Code 由于能够操控电脑和文件,相当于有了手和脚,因此能够提供的助力会更多。
Claude Code 并非只能用 Claude 家的模型,其他家的模型也可以用。Claude Code 实际上是一个 Agent 框架,可以理解为,它是一辆车的车架,而它跑快跑慢,取决于安装什么发动机,Claude 模型是原装发动机,最为匹配,但安装了 Gemini、Qwen、Kimi 等其他品牌的发动机,照样可以跑起来。
Claude Code 官网:
claude.comClaude Code 官方文档:
code.claude.com# 安装与配置过程
## 安装 Node.js
Node.js 在 AI 时代其实是非常常用的编程依赖,在各种命令行工具、AI Coding 等场景,都需要用到 Node.js,如果要开发网站,那非常建议用 Next.js 框架,也需要以 Node.js 为基础。
访问官网
nodejs.org ,选择一个标记了"LTS"的长期支持正式版本,小白可以采用下载安装的方式,点击下载 Mac 版本的 .pkg 安装包,正常安装即可。
注意,在安装 Claude Code 的过程中,Node.js 不是必须的,在没有 node.js 的情况下,依然可以使用下方的 Bash 命令来进行原生安装程序。
## 终端安装 Claude Code
打开电脑的终端,Mac 电脑按「Command+空格」键,搜索"终端",回车进入终端,进入命令行界面。
在终端中,在"用户名~% "后面,直接输入 Claude Code 在 Node.js 下的 npm 安装命令(需要安装好 node.js):
npm install -g @anthropic-ai/claude-code
或者使用 Bash 命令(无需 node.js,但对于网络端口有要求):
curl -fsSL
claude.ai | bash
这些过程无脑粘贴即可,无需为看不懂这些代码而困扰。Claude Code 也提供了中文版本的技术文档,可以阅读参考,以便更好了解 Claude Code 的工作原理
code.claude.com 。
运行命令后,大约有 50%概率报错,当你看到终端返回的结果中,有大片的"error"后,那就是报错了。大部分情况是权限、环境和网络问题引起的,解决起来不会很复杂。
接下来,只需要把报错信息「Command+A」全选,「Command+C」复制,然后「Command+V」粘贴到任意一个新一点的旗舰模型,比如国内的 GLM 5 、Qwen 3.5 、Kimi 2.5,国外的 Gemini 3 、GPT 5.3 等,AI 会告诉你接下来怎么办。
这里有一个注意事项,在终端使用授权时,尽量减少权限范围,比如能给文件夹权限,就不要给用户管理权限,能给用户管理权限,就不要给管理员权限。权限过高是有风险的,尤其是对于小白来说,因此,要审慎授权,不确定的就多问问 AI。
解决了报错问题后,再次执行 Claude Code 安装命令,完成安装。
## 验证 Claude Code 安装
安装完成后,可以在终端运行 claude --version 命令,这个命令是查看 Claude Code 的版本号,如果返回的结果是版本数字,那么说明安装成功。
## 在目标位置启动 Claude Code
在终端中,输入"Claude",即可进入 Claude Code,这个过程中,可能需要你进行一些文件夹授权。然后,你就会看到一个棕色的小机器人,恭喜你,进入 Claude。
这里必须讲一下,在使用 AI 的过程中,文件夹是一个非常关键的概念,相当于需要给一个 AI 发挥功力的范围。我一般是在「文稿」当中创建一个单独的文件夹,后续的 AI 开发、项目文件、AI 相关的内容,都放在这个文件夹中。然后,将这个文件夹授权给各种 AI,他们都在这个文件夹范围内工作。
为 Claude Code 指定文件夹范围,有 3 种方法:
1. Mac 直接在目标文件夹上,右键选择「服务」,然后选择「新建位于文件夹位置的终端窗口」,此刻会自动打开一个终端,终端的位置,就是在这个文件夹的范围下。在这个终端里,输入 Claude,就是在这个文件夹下打开 Claude Code。
2. Mac 电脑按「Command+空格」键,搜索"终端",回车进入终端,进入命令行界面,输入"cd(空格)",表达要进入某一个文件夹,然后把想要进入的文件夹直接拖进终端,会自动形成文件夹路径,回车。当终端的路径变为文件夹名称时,说明此刻终端就已经部署在目标文件夹下了,输入"Claude"启动即可。
3. 在方法 2 的基础上,手动输入 Mac 文件夹路径,这个操作有点复杂,也不好记,就不展开讲了。
## 配置 Claude Code 使用其他模型
第一次使用 Claude Code 的时候,官方默认的引导目录,会提示登录 Claude 账号。但 Claude 封号严重,而且 Claude 的 API 也比较贵,最重要的是,如果你能搞定 Claude API ,那么肯定也不必来看这篇文章。
按照大多数人的用法,都会选择购买其他模型的 Coding Plan 套餐,或者接入 API 使用。
我手头正好有一个 DeepSeek 的 API Key,就用 DeepSeek 进行演示,其他模型接入都是类似的。
首先需要有一个 API Key,打开 DeepSeek 开放平台
platform.deepseek.com ,创建 API Key 即可。注意,这个 API Key 创建后,只展示一次,所以请务必妥善保存好,也不要泄漏,否则任何人都能通过这个 Key 使用模型的额度。当然如果丢失或者泄漏,就在 Key 管理这里,删除掉旧 Key,然后新建一个 Key 重新配置即可。
在目标位置打开终端,此时不要打开 Claude,而是先配置环境变量,这里的意思是,告诉 Claude,现在要更换它运行的环境配置,把它默认的 Claude API,换成 DeepSeek API 。
终端中直接输入以下内容,注意,把「${DEEPSEEK_API_Key}」这一段话,替换为 API Key,格式为「"sk-XXXXXX"」,注意,引号要使用英文状态下的半角引号。
export ANTHROPIC_BASE_URL=
api.deepseek.comexport ANTHROPIC_AUTH_TOKEN=${DEEPSEEK_API_Key}
export API_TIMEOUT_MS=600000
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
此时,Claude Code 使用的模型,就是 DeepSeek 了。如有有更多问题,可以把 DeepSeek 的官方文档
api-docs.deepseek.com ,丢给任何一个新一点的旗舰模型问一下。
接下来,就可以使用有 DeepSeek 驱动的 Claude Code 了,可以先试着问它一些问题,或者让它写一个自我介绍,以 Markdown 格式输出在当前文件夹,就会发现在目标文件夹下,会多出一个 .md 文件,是它的自我介绍。
除了使用 API,GLM、Kimi、Qwen 等很多国产模型也都提供了 Coding Plan 套餐,相当于一个包月的不限量服务,配置方法类似,按照官网的教程操作即可。
## 终端使用小技巧
打开终端,都是代码,确实很唬人,但先不要害怕,我们理解一下终端。
终端就是没有界面的操作系统,我们使用 Mac 电脑,有各种各样的软件窗口,但实际上,这些窗口是为了让人类更方便的可视化操作。理论上来说,界面中能够进行的动作,都可以在终端中直接用代码命令进行。
【进入终端中的软件】
- 当我们在终端中输入"Claude"的时候,就相当于进入了系统里的 Claude 这个软件;
- 然后我们再按两下「Control+D」按键,就是退出了 Claude。
【在终端的 Claude 中粘贴图片】
- 网页版对话中,经常发送一张图片给 AI,在终端的 Claude 中,这个粘贴图片的快捷键,变成了「Control+V」,稍微有点不习惯,但很快就能适应。
所以,我们只需要像使用软件一样使用终端即可,除了不能用鼠标,只能输入对应的命令代码之外,和使用软件是一样的逻辑。
这里有一篇文章
sspai.com ,展开讲解了终端的原理和一些有趣的操作,如果你有兴趣深入了解一下终端,可以进一步阅读。
# 工具塑造工作
工具的诞生,往往是因为工作过程中,有一些高频的操作需要重复做,因此标准化成工具,来实现生产效率的提升。
但反过来,当一个先进工具被更多人使用后,工具本身的特性,也会塑造工作的方式。
我举一个非常典型的例子:
【开始习惯用 Markdown 写文档】
- Claude Code 作为对本地文件有操作权限的 Agent,它作用的落脚点是文档,当你要深度使用 Claude Code 的时候,就会发现,传统的 Word 或者在线的飞书文档,都不太好使,最好的方式,是本地的 Markdown 文本文件。Markdown 本质上是纯文本,AI 能够最高效的读取文件,也能够非常方便的进行编辑。
- 于是,工作流就会变成,在本地创建一个 Markdown 文件,写入你的需求,然后告诉 Claude Code:"读取某某文件夹的 XX 需求.md 文档,完成需求的分析和完善,并将完善的结果回写到文档中"。
- 后面每一个重大变更,都可以让 Claude 写一个本地的 Markdown 文档记录下来,这些 Markdown 就成为项目中最稳定的上下文记忆,后面只需要按需读取即可。
还有很多其他的影响,比如关注目录结构,关注文件系统的架构,关注 AI 产出的标准化,等等,这些都是先进工具对于工作方法的塑造,正如 Excel 横空出世之后,财务人员再也不需要耗费大量时间抄写数字和按计算器。
在当下的节点,Claude Code 未必是未来效率的最优解,但一定是一个新时代的起点。