文章总结： 本文介绍了ClaudeCodeCLI工具的安装配置与使用技巧。核心内容包括通过npm安装CLI、配置APIKey及切换工具、以及利用Claude.md维护项目上下文。文章还推荐了前端设计与头脑风暴等实用插件，并强调了Thinking模式与文件权限管理在安全编码中的重要性，适合开发者提升AI辅助编程效率。 综合评分： 86 文章分类： AI安全,安全开发

Claude Code入门食用指南

原创

黑晶

黑晶

2025年12月30日 19:38 浙江

Claude Code入门食用指南

“

官网地址：https://claude.ai/ (由于某些原因需要科学上网)

安装

Claude目前主要有两种形式的工具:

1. 一种是类似ChatGPT交互形式,有网页版，也有desktop app。

2.还有一种是Claude CLI，通过类似于命令行交互的方式来执行不同的功能。

前者安装直接去官方下载安装使用就行了，文章后面的内容主要以ClaudeCli为主。

Cli安装推荐通过npm的方式来安装，这种方式windows和macos下均通用,而npm安装其实就是去装一下nodejs,直接到官网：https://nodejs.org/en/download,根据不同的系统，在命令行下运行给你的指令就行了。 安装完nodejs，就可以通过如下命令安装ClaudeCLI了： npm install -g @anthropic-ai/claude-code 然后进入工作文件夹输入命令行运行 Claude 如果看到类似上面截图的输出，说明安装成功了。

坑点

1. npm安装Cli的时候提示超时等信息，这是因为你的node没走科学上网，这个需要你的科学上网切换到tun模式，或者利用proxifier等软件把你的node进程代理出去。
2. 类似permission denied等权限不足的信息，我的解决方法是把原来的老旧的node卸载了装一下新的，最好用nvm安装node。

使用

Claude的工作控件是以文件夹为基础的，所以你需要到你的工作目录下，通过命令行运行Claude

cd your-projectclaude

之后在当前Claude会话周期内，作用域仅限于当前文件夹以及子文件夹的范围内，默认情况下使用他的功能比如补全，读取文件，优先都是在当前文件夹内区查找的，除非你明确授权了之外的路径。

API 导入

ClaudeCLI使用的时候需要验证，一种方式是自动通过web登录认证，还有一种是利用API key,一般后者用的比较多，用起来也比较灵活。

Claude配置APIKEY一般在Claude目录名为settings.json文件中

ounter(lineounter(linewindows上这个文件在：C:\Users\用户名\.claude\settings.jsonmac上这个文件在：~/.claude/settings.json

通过apikey可以很方便的配置不同厂商的接口。 但是如果每次都要去手动配置的话，就会很烦，推荐一个随时切换API的工具:https://github.com/farion1231/cc-switch

在里面你可以提前配置好你的CC供应商的api,使用的时候一键切换即可。

Claude.md

用Claude的人好像大多数人其实不会去创建和使用Claude.md,其实如果你去实现一个很小的东西，这个确实不用也可以，但是假如你要实现的项目比较大比较复杂，尤其是需要迭代维护，跟踪状态的项目，这个还是需要的。 Claude.md的作用我个人认为主要有两个：

• 给claude提供项目特定的持久上下文和指令，因为你不可能让claude一直运行下去，如果下次运行的，claude可以通过这个文件快速或者项目的相关信息。
• “规范手册”,让它在编码时严格遵守你的风格、流程和偏好，这样不用每次都重复说明，你可以指定你的技术栈，你也可以指定”行动红线”，比如不要删除文件。。。

一个好的Claude.md真的能给你在后续的编码中省掉很多麻烦事，不用每次会话都去强调一些重复的东西。 刚开始的话可能不知道怎么去写这个文件，其实可以参考类似：https://github.com/ruvnet/claude-flow/wiki/CLAUDE-MD-Templates ,然后自己去尝试即可，你就可以感受到有和没有Claude.md 之间使用体验上的差异了。

付费订阅问题

目前官方的版本有free，pro，max 三种等级，pro每月20刀，max 200刀，支付的话不支持国内的常用的支付包等方式，需要外币MasterCard，一般内地的用，有一个方式就是走中转的方式，会有一些提供商提供这种服务，你接入他的API，按照他的计费规则来订阅。 但是这里有坑点需要注意：

• 有的中转商会掺杂水分进去，说白了就是替换模型，比如你要用opus4.5，它给你替换成其他的，这种很多人刚开始用很难分辨出来。
• 要找有一定口碑的，防止跑路。
• 也有部分提供商是通过逆向一些三方的AI agent服务得到的大模型访问权限，这种的话也是有风险的，存在被封堵的可能。

我这里就不推荐了，免得出现广告嫌疑，有兴趣可以加文末的群交流。

Claude skill

简单来说，Claude skill作用就是给你的Claude点天赋，加技能，从新手变成老手，具体的原理前期你不用去管，会用就行了，如何安装呢？ 直接输入/plugin,你就可以看到如下的插件搜索界面： [img] 然后搜索安装你想要的skill就行。 如果你要安装第三方的skill的话，需要先安装对应的marketplace: /plugin marketplace add xxxxxx。 这里推荐两个插件，以及相应的安装过程：

• frontend design skill – 前端设计技能，一般情况下claude设计前端的时候，都会用清一色的紫色作为页面配色方案，很难看，用这个的话会效果好很多。 安装过程：

  

• brainstorming skill – 主要用于帮助 Claude 在任务开始前进行brainstorm，主要就是把你给它的粗糙的概念炼成完整设计流程，特别适合编码、规划前使用。 安装过程：

  /plugin marketplace add obra/superpowers-marketplace //安装三方插件市场/plugin install superpowers@obra    //安装superpowers插件，brainstorm skill就在里面

安装成功后输入/help,通过tab切换到custom-commands页面，如果如下图一样，说明安装成功。

Thinking 模式

• 普通模式下，Claude 像一个“快速反应”的聪明助手：问题一来，立刻给出答案，适合简单聊天或日常任务。
• 开启 Thinking Mode 后，Claude 就像一个“认真思考的学生”：遇到复杂问题时，会先“暂停”一会儿，在内部一步步推理、分析备选方案、验证想法（这些思考过程有时可见），然后再给出最终答案。这样答案更准确、更深入，但会慢一些。
• windows下alt+t开启
• macos下opt+t开启

交互

这个跟你在web聊天框里面的使用是一样的，你也可以使用esc打断当前正在进行的对话，提一些你的需求。 然后Claude操作文件的时候会向你询问权限，我建议不要给完整的权限，最好是让你确认一下，避免出现删除文件等一些高危的操作，如果不能恢复的话，对你的项目造成的损失还是很大的。

我创建了一个交流群，主要用于探讨AI时代更多的Vibe Coding的玩法，欢迎加入👇

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：黑晶 黑晶《Claude Code入门食用指南》