给小白的 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 由于能够操控电脑和文件，相当于有了手和脚，因此能够提供的助力会更多。

Tips:

Claude Code 并非只能用 Claude 家的模型，其他家的模型也可以用。Claude Code 实际上是一个 Agent 框架，可以理解为，它是一辆车的车架，而它跑快跑慢，取决于安装什么发动机，Claude 模型是原装发动机，最为匹配，但安装了 Gemini、Qwen、Kimi 等其他品牌的发动机，照样可以跑起来。

Claude Code 官网：https://claude.com/product/claude-code

Claude Code 官方文档：https://code.claude.com/docs/zh-CN/overview

安装与配置过程

安装 Node.js

Node.js 在 AI 时代其实是非常常用的编程依赖，在各种命令行工具、AI Coding 等场景，都需要用到 Node.js，如果要开发网站，那非常建议用 Next.js 框架，也需要以 Node.js 为基础。

访问官网 https://nodejs.org/en/download，选择一个标记了“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 https://claude.ai/install.sh | bash

这些过程无脑粘贴即可，无需为看不懂这些代码而困扰。Claude Code 也提供了中文版本的技术文档，可以阅读参考，以便更好了解 Claude Code 的工作原理 https://code.claude.com/docs/zh-CN/overview。

运行命令后，大约有 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. 1. Mac 直接在目标文件夹上，右键选择「服务」，然后选择「新建位于文件夹位置的终端窗口」，此刻会自动打开一个终端，终端的位置，就是在这个文件夹的范围下。在这个终端里，输入 Claude，就是在这个文件夹下打开 Claude Code。

1. 2. Mac 电脑按「Command+空格」键，搜索“终端”，回车进入终端，进入命令行界面，输入“cd（空格）”，表达要进入某一个文件夹，然后把想要进入的文件夹直接拖进终端，会自动形成文件夹路径，回车。当终端的路径变为文件夹名称时，说明此刻终端就已经部署在目标文件夹下了，输入“Claude”启动即可。

1. 3. 在方法 2 的基础上，手动输入 Mac 文件夹路径，这个操作有点复杂，也不好记，就不展开讲了。

配置 Claude Code 使用其他模型

第一次使用 Claude Code 的时候，官方默认的引导目录，会提示登录 Claude 账号。但 Claude 封号严重，而且 Claude 的 API 也比较贵，最重要的是，如果你能搞定 Claude API ，那么肯定也不必来看这篇文章。

按照大多数人的用法，都会选择购买其他模型的 Coding Plan 套餐，或者接入 API 使用。

我手头正好有一个 DeepSeek 的 API Key，就用 DeepSeek 进行演示，其他模型接入都是类似的。

首先需要有一个 API Key，打开 DeepSeek 开放平台 https://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=https://api.deepseek.com/anthropic
export 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 的官方文档 https://api-docs.deepseek.com/zh-cn/guides/anthropic_api，丢给任何一个新一点的旗舰模型问一下。

接下来，就可以使用有 DeepSeek 驱动的 Claude Code 了，可以先试着问它一些问题，或者让它写一个自我介绍，以 Markdown 格式输出在当前文件夹，就会发现在目标文件夹下，会多出一个。md 文件，是它的自我介绍。

除了使用 API，GLM、Kimi、Qwen 等很多国产模型也都提供了 Coding Plan 套餐，相当于一个包月的不限量服务，配置方法类似，按照官网的教程操作即可。

终端使用小技巧

打开终端，都是代码，确实很唬人，但先不要害怕，我们理解一下终端。

终端就是没有界面的操作系统，我们使用 Mac 电脑，有各种各样的软件窗口，但实际上，这些窗口是为了让人类更方便的可视化操作。理论上来说，界面中能够进行的动作，都可以在终端中直接用代码命令进行。

【进入终端中的软件】

• 当我们在终端中输入“Claude”的时候，就相当于进入了系统里的 Claude 这个软件；
• 然后我们再按两下「Control+D」按键，就是退出了 Claude。

【在终端的 Claude 中粘贴图片】

• 网页版对话中，经常发送一张图片给 AI，在终端的 Claude 中，这个粘贴图片的快捷键，变成了「Control+V」，稍微有点不习惯，但很快就能适应。

所以，我们只需要像使用软件一样使用终端即可，除了不能用鼠标，只能输入对应的命令代码之外，和使用软件是一样的逻辑。

这里有一篇文章 https://sspai.com/post/45534，展开讲解了终端的原理和一些有趣的操作，如果你有兴趣深入了解一下终端，可以进一步阅读。

工具塑造工作

工具的诞生，往往是因为工作过程中，有一些高频的操作需要重复做，因此标准化成工具，来实现生产效率的提升。

但反过来，当一个先进工具被更多人使用后，工具本身的特性，也会塑造工作的方式。

我举一个非常典型的例子：【开始习惯用 Markdown 写文档】

• Claude Code 作为对本地文件有操作权限的 Agent，它作用的落脚点是文档，当你要深度使用 Claude Code 的时候，就会发现，传统的 Word 或者在线的飞书文档，都不太好使，最好的方式，是本地的 Markdown 文本文件。Markdown 本质上是纯文本，AI 能够最高效的读取文件，也能够非常方便的进行编辑。

• 于是，工作流就会变成，在本地创建一个 Markdown 文件，写入你的需求，然后告诉 Claude Code：“读取某某文件夹的 XX 需求。md 文档，完成需求的分析和完善，并将完善的结果回写到文档中”。

• 后面每一个重大变更，都可以让 Claude 写一个本地的 Markdown 文档记录下来，这些 Markdown 就成为项目中最稳定的上下文记忆，后面只需要按需读取即可。

还有很多其他的影响，比如关注目录结构，关注文件系统的架构，关注 AI 产出的标准化，等等，这些都是先进工具对于工作方法的塑造，正如 Excel 横空出世之后，财务人员再也不需要耗费大量时间抄写数字和按计算器。

在当下的节点，Claude Code 未必是未来效率的最优解，但一定是一个新时代的起点。

文/亨亨（始终是产品经理）

微信：xiaozidaheng

微信公众号：产品变量（ID：hengpaper）