跳至主要內容

[闭源工具]快速入门Claude Code

whoway2026/2/11大约 7 分钟

[闭源工具]快速入门Claude Code

1、[SOP]解决国内claude code的配置

1.安装claude code客户端

【SOP】不使用npm去安装，因为我是研发，很可能切换不同npm
所以我使用mac的brew安装个不依赖于指定版本npm的claude code

brew install --cask claude-code

# 然后就可以
➜  ~ which claude
/opt/homebrew/bin/claude

2.切换claude code模型底层供应商

我使用的是直接修改`

3.针对可视化选中的场景，使用vscode的Claude Code for VS Code插件

2、原理解析：claude code工具底层原理

可以在任何github.com项目查看的时候将github变成deepwiki去问问题，AI会帮你解析

prompt如下

这个工具最核心的应该是上下文工程和提示词工程吧？告诉我具体的提示词工程咋设计的？源码是什么？上下文工程又是咋设计的，源码是什么？

Claude Code 的核心确实是上下文工程和提示词工程。让我详细解释这两个系统的设计和源码实现。

其他概念

技巧1：rules这种能提开发效率的东东

但是我觉得，这种基本上只能在项目中一个个积累

如果你想用Cursor完成企业级项目，你需要正确使用Proejct Rules

Claude Code 在近期的 2.0.64 版本支持了.claude/rules/ 这个文件夹，概念取自cursor rules。

  • rules: 适合放guidelines、convention（ 惯例，习俗，规矩）
  • skills: 操作手册 + 工具箱 + 示范

最佳实践

  • 在项目根目录使用 .claude/rules/ 存放项目特定的指令，维护清晰的项目结构，帮助 Claude Code 理解代码库

为什么代码会漂移？因为没有持久化的规矩，Claude Code 只能靠短期记忆。

试试这份rules配置，你会发现它突然变得“听话”很多。

技巧2：skills这种能提效的东东

如果想将你某个项目的skills也放到全局生效，那你要把他移动一下

比如mac是这个全局的目录下面：~/.claude/skills/

➜  agent-skills-examples git:(main) ✗ mkdir -p ~/.claude/skills   
➜  agent-skills-examples git:(main) ✗ cp -rf 帮我写作 ~/.claude/skills

在claude code中skills 是以文件夹的形式存放在

项目目录/.claude/skills/skill-namel/ 
项目目录/.claude/skills/skill-name2/

每个skill就是1个文件夹，每个skill至少包含一个SKILL.md【注意，必须是大写的SKILL】的定义文件
这个定义文件里面存放的是skill的元数据层与指令层的内容

在skill的这个文件夹里面，还可以放入其他类型的辅助文件，这些文件就是skill 的资源层（可选）
image.png

  • 图示来自：技术爬爬虾

1个SKILL.md示例

先来写这个skill 的metadata，元数据用六个横杠包裹起来

---
name: 帮我写作
description: 结合用户提供的材料进行文案写作
---

里面只需要填上这个skill 的名字然后它的描述就可以了
描述部分最重要是写清楚Al应该在什么时机来调用这个skill
元数据写完后，我们来写指令，指令部分就可以写的详细一点了

结合我发你的材料，撰写一篇深度文案，输出到项目根目录
如果是软件/AI/计算机相关的材料，请先阅读参考 references/ 里面所有的范文，学习我的行文风格。
如果是其他方面材料的则无需参考范文。

其他要求如下：
- 整体行文要流畅、易于口播
- 节奏感强：多用短句，逻辑清晰，观点有衔接，段落之间过渡自然，读起来顺滑。
- 正文用 2–4 个清晰的小节拆解。
- 观点鲜明：语气自信、果断，敢于下结论。
- 不需要写画面调度。

  

## 后续处理

你先检查我名下有没有 ai-docs的Github仓库，如果没有就用create_repository MCP工具来创建一个仓库，然后把你刚才写好的文件，用create_or_update_file MCP工具上传到这个仓库。

一个完整的Skill 就定义完成了

总结，重点有3个

  • 首先是目录结构：.claude/skills/字母转markdown/SKILL.md
  • 第二个是skill 定义文件的文件名：SKILL.md
  • 第三个就是这里的元数据
    搞定后，你在claude中就能使用/skills看到咋们自定义的skill了
    image.png

SKILL的底层原理

情况1
image.png

情况2
image.png

最后
image.png

skills的进阶用法：资源层

还可以放入任意类型的辅助文件
这些文件就可以作为这个skill 的资源
比如

  • 资源文件可以是可执行脚本
  • 可以是补充说明文档
  • 也可以是图片等其他的资源

在Agent Skilks开放标准有推荐：https://agentskills.io/what-are-skills

对比

image.png
image.png

skills编写难度较小只需要编写一个markdown 文件就可以使用基础功能

附录4、关于skill的安全性

由于 Skill 可以包含 Python 脚本并执行系统命令，安全性至关重要。
Claude Agent SDK 默认在容器化环境（Docker Container）或受限的沙箱中运行这些 Skill1。
网络隔离：限制 Skill 只能访问特定的 URL（如 API 端点）。

文件系统隔离：Skill 只能读写特定的工作目录，无法访问宿主机的系统核心文件。

这是 Skill 区别于简单 Prompt 的重要特征：它是在一个受控的计算环境中运行的，而不仅仅是在文本框里生成文字。

附录5、关于claude code的skills的层级

比如下面：有项目的skills，也有全局的用户skills

7 SkiLLs

Project skills（.claude/skills）
vercel-react-best-practices • ~89 tokens 
planning-with-files• ~78 tokens
react-useeffect• ~58 tokens
web-design-guidelines•~52 tokens
给接口生成openapi格式的接口文档•~33 tokens rigorous-coding•~25 tokens

User skills（~/-Claude/skills）
帮我写作•~5 tokens

escape to close

那么问题来了，如果我是1个vscode的工作区，我在工作区那里配置了.claude/skills
那么，我在某个子项目下使用claude code看skills会发生什么呢？
不会看到工作区的skills

  • 在工作区根目录配置了 .claude/skills/

  • 在 fe/ 子目录中没有 .claude/

  • 在 fe/ 中工作时 找不到 skills

这揭示了 Claude Code 的实际查找行为：

## 关键限制：工作区文件夹边界

在 VS Code 中：

- **工作区根目录** ≠ **工作区文件夹**
- 当你打开一个包含多个文件夹的工作区时：
    json
    
    // workspace.code-workspace
    {
      "folders": [
        { "path": "fe" },    // ← 这是一个工作区文件夹
        { "path": "be" }     // ← 这是另一个工作区文件夹
      ]
    }
**实际限制**：
1. **每个工作区文件夹是独立的上下文**
2. Claude Code **不会跨文件夹边界**查找
3. 即使它们在同一个物理工作区文件中

附录1、关于claude code搭配的供应商

附录2、关于rules、agent、command等资料

附录3、开源的claude code配置

Rulestypescript.mdTypeScript 命名、类型规范
Rulestesting.md强制写测试用例
Rulescomments.md统一注释风格
Agentscodebase-search快速搜索代码库实现
Agentstech-docs-writer自动生成技术文档
Hookscheck-comments.py写文件前检查是否加了注释

附录4、claudecode的使用技巧

1.你可以拖文件到claude code命令行工具

他会自动把文件路径给粘贴到claude code对话框，自然就形成了那种你选中这个文件的样子
模拟了一部分GUI的那种效果

2.编写好的skill可以给哪些用？

  • claude code
    • ~/.claude/skills/
  • codex
    • ~/.codex/skills/

参考资料