⚡Claude Code使用教程⚡ – Everfadesの技术论坛

本文最后更新于59 天前，其中的信息可能已经过时，如有错误请发送邮件到everfades1218@gmail.com

2026.4.21-by——Everfades

⚠必读：

本教程仅适用于Windows系统，ios系统后续会逐步更新。

如果您有意见或建议，请发邮箱至everfades1218@gmail.com

在使用Typora阅读前，请将文件→偏好设置→Markdown→内联公式勾选上，以免显示出错！

感谢您阅读本文章！

💡引言–Claude Code是什么？

截至今天(4.21），我仍然认为Claude Code是所有Agent中最出彩的那个，vibe coding的版本答案。

一款Agent产品包含两个部分，Agent框架 + 模型，而Claude Code本质上属于前者，但平时在聊到ClaudeCode的时候，都是把它作为一款完整的产品聊的。

Claude的公司–Anthropic对墙内一直不是很友好，ClaudeCode的官方模型opus也自然用不了，很难搞，我也没有一种能公开发出来的办法教大家弄，Anthropic天天封号，特别狗，最近又搞上实名认证，明摆着就是想把墙内一刀切了，但不得不承认的是，目前世界上最好的Agent框架，依旧是Claude Code。

用不了opus没关系，因为Claude Code本质上就是个Agent框架，搭配什么模型都可以用，即使现在openclaw，Hermers啥的都非常火，但我认为目前仍然撼动不了Claude的地位，即使搭配国产模型，Claude Code带给你的体验也会很好，而且不用担心封号问题，这篇教程甚至连科学上网都不用，只要照着做，基本能避开99%的问题

不啰嗦了，我们进入正题——

一.Claude Code安装

因为Claude Code在Windows上内部是用Git Bash来执行命令的，所以要想在Windows上用Claude Code，必须先把Git安装上。

我们使用Windows官方的包管理器WinGet来安装，WinGet可以理解成Windows版的Homebrew

首先我们按 win+R，在框框里输入cmd

点击确定，启动PowerShell，CV以下命令，并点击Enter键运行

winget install Git.Git

下载完成后会弹窗获取权限，授权即可安装(没弹窗则不用管)

显示”Successfully installed”或者中文”已成功安装”代表安装成功

接下来在终端中运行这条命令

winget install Anthropic.ClaudeCode

我们在终端里输入claude，就能进到Claude Code页面了。

但是，我们这里只是装了框架，还没有接入模型，所以还没法用。

二.CC Switch安装

点击下方链接下载CCswitch

通过网盘分享的文件：CC-Switch-v3.13.0-Windows.msi 链接: https://pan.baidu.com/s/1r7ku91HMh0NOpbivoB3phA?pwd=0721 提取码: 0721

下载好后正常安装即可，不需要切换安装路径的话一路next即可安装，需要切换路径的手动改一下即可

安装好后我们启动CC Switch，一进去我们就能看到，这款工具不仅适用于Claude Code，像Gemini，GPT，openclaw这些都可以用。

三.接入模型

为了方便演示，我们使用智谱GLM 大模型来举例

在Claude那一栏下面，我们点击右上角的模型，新增模型配置。

选择 Zhipu GLM

鼠标滚轮向下滑，会发现需要我们填很多东西，我们主要关注的是这个API Key，获取API Key的方法也很简单，我们只需要点击这里的获取”API Key”，就会自动帮我们打开智谱官网

进入后，先登录，再点击控制台

下滑，点击新建API，随便输入一个名字，即可新建API

我们将API复制粘贴到CC Switch中

配置好APi后，我们还需要指定具体的模型，我们获取API相当于告诉ClaudeCode，我要用GLM模型，但是还没有决定具体用哪个模型。

我们点击”接入指南”

点击 “使用指南” –> “免费模型”–>”GLM-4.7-Flash”，向下滑找到”调用示例”，并复制model，为了方便演示，就先用免费模型了。

我们将”glm-4.7-flash”粘贴进CC Switch这几个模型中，都填好之后，点击”添加”即可

到这一步，我们就已经完成配置了

四.Claude Code基础使用

由于在cmd中启动，claude访问的是你的用户目录，安全起见我们可以在D盘根目录中新建一个名为ClaudeCode_WorkSpace的文件夹，并在文件夹中右键–>“在终端中打开”即可

或者我们也可以直接win+R，输入cmd，然后输入以下命令

cd “D:\ClaudeCode_WorkSpace”

输入这条命令后，你的终端还是会显示C盘用户文件夹，此时再输入”D:”即可显示你切换的路径，再输入claude并回车即可启动claude

第一次使用Claude Code需要修改一些配置文件，比如颜色提示，选择困难症可以直接选第一个Auto选项。

第二个则是安全提示，这么些话总结起来就两件事：

Claude会犯错，它写的代码你要过一遍。
只在你信任的代码库里用Claude Code，避免提示词注入攻击。

我们点击Enter确认就可以

最后一步，就是和你确认当前所在目录，是否可以信任。我们选择YES，然后回车

这样就来到我们接入模型的ClaudeCode对话界面了，如果想换用其他模型，在CC Switch里配置好，然后在Claude Code里使用/model命令切换就可以了

至此，Claude Code的基础用法就到这里了，我们可以正常和Claude Code对话，完成各种任务，后面的进阶用法是为了大家用起来更加丝滑，大家可以有选择的阅读。

五.进阶用法

1.我不想点Allow了！

在写代码的过程中，Claude会发出许多关于代码是否可以修改的请求，一个一个点Allow点到怀疑人生，我们可以用这行命令

claude –dangerously-skip-permissions

这条命令给了claude自己决定风险决策的权限，它会直接将代码改好而无需我们的Allow。

2.懒人启动法

Claude Code不仅可以通过cmd的cd命令导航到指定文件夹再启动，也可以通过文件管理器，在想要修改的目录下右键启动终端再启动claude.

3.版本更新了！？

Claude Code版本更新的速度很快，在写这篇文章的时候，就从2.1.114更新到了2.1.116。面对版本更新，我们只需输入这行命令

winget upgrade Anthropic.ClaudeCode

即可更新到最新最热的Claude Code🔥

4.来写写CLAUDE.md(※)

①官方文档

让我们先看看官方给出的说明文档：

Write an effective CLAUDE.md

💡Run to generate a starter CLAUDE.md file based on your current project structure, then refine over time./init

CLAUDE.md is a special file that Claude reads at the start of every conversation. Include Bash commands, code style, and workflow rules. This gives Claude persistent context it can’t infer from code alone.

The command analyzes your codebase to detect build systems, test frameworks, and code patterns, giving you a solid foundation to refine./init

There’s no required format for CLAUDE.md files, but keep it short and human-readable. For example:

# Code style 
- Use ES modules (import/export) syntax, not CommonJS (require) 
- Destructure imports when possible (eg. import { foo } from 'bar') 
# Workflow 
- Be sure to typecheck when you're done making a series of code changes 
- Prefer running single tests, and not the whole test suite, for performance

CLAUDE.md is loaded every session, so only include things that apply broadly. For domain knowledge or workflows that are only relevant sometimes, use skills instead. Claude loads them on demand without bloating every conversation.

Keep it concise. For each line, ask: “Would removing this cause Claude to make mistakes?” If not, cut it. Bloated CLAUDE.md files cause Claude to ignore your actual instructions!

✅ Include	❌ Exclude
Bash commands Claude can’t guess	Anything Claude can figure out by reading code
Code style rules that differ from defaults	Standard language conventions Claude already knows
Testing instructions and preferred test runners	Detailed API documentation (link to docs instead)
Repository etiquette (branch naming, PR conventions)	Information that changes frequently
Architectural decisions specific to your project	Long explanations or tutorials
Developer environment quirks (required env vars)	File-by-file descriptions of the codebase
Common gotchas or non-obvious behaviors	Self-evident practices like “write clean code”

If Claude keeps doing something you don’t want despite having a rule against it, the file is probably too long and the rule is getting lost. If Claude asks you questions that are answered in CLAUDE.md, the phrasing might be ambiguous. Treat CLAUDE.md like code: review it when things go wrong, prune it regularly, and test changes by observing whether Claude’s behavior actually shifts.

You can tune instructions by adding emphasis (e.g., “IMPORTANT” or “YOU MUST”) to improve adherence. Check CLAUDE.md into git so your team can contribute. The file compounds in value over time.

CLAUDE.md files can import additional files using @path/to/import syntax:

See @README.md for project overview and @package.json for available npm commands.

# Additional Instructions
- Git workflow: @docs/git-instructions.md
- Personal overrides: @~/.claude/my-project-instructions.md

You can place CLAUDE.md files in several locations:

Home folder (~/.claude/CLAUDE.md): applies to all Claude sessions
Project root (./CLAUDE.md): check into git to share with your team
Project root (./CLAUDE.local.md): personal project-specific notes; add this file to your .gitignore so it isn’t shared with your team
Parent directories: useful for monorepos where both root/CLAUDE.md and root/foo/CLAUDE.md are pulled in automatically
Child directories: Claude pulls in child CLAUDE.md files on demand when working with files in those directories

②CLAUDE.md的Include和Exclude

总而言之，这个说明文档向我们传达了下面的信息

宏观来看，合格的CLAUDE.md应该包含以下内容：

WHAT：告诉 Claude 相关技术、你的技术栈、项目结构。给 Claude 一张代码库地图。这对单一代码仓库尤为重要！告诉 Claude 哪些是应用程序，哪些是共享包，以及所有内容的用途，以便它知道去哪里查找东西。
WHY：告诉 Claude 项目的目的以及仓库中各项内容的作用。项目不同部分的目的和功能是什么？
HOW：告诉 Claude 它应该如何在这个项目上工作。例如，你使用的是 bun 还是 node？需要包含所有能让 Claude 开展实质性工作的信息。如何验证修改？怎样运行测试、类型检查和编译流程？

但我们的实现方法尤为重要，在刚刚开始写CLAUDE.md时，大家可能会写很多很多条，认为写的越多越好，但这样只会适得其反。

在实际使用后，我们注意到Claude开始渐渐忽略我们CLAUDE.md中强调过的内容，我们可以通过使用 ANTHROPIC_BASE_URL 在 Claude Code CLI 和 Anthropic API 之间放置一个日志代理来亲自调查此事。Claude Code 会在发送给 AI 智能体的用户消息中注入以下带有 CLAUDE.md 文件的系统提示：

<system-reminder>
      IMPORTANT: this context may or may not be relevant to your tasks. 
      You should not respond to this context unless it is highly relevant to your task.
</system-reminder>

结果是，如果 Claude 决定你的 CLAUDE.md 内容与其当前任务无关，它就会忽略这些内容。文件中包含的与当前处理任务并非普遍适用的信息越多，Claude 就越有可能忽略你在文件中的指令。

因此我们需要遵循一个少即是多的原则，一些研究表明了以下几点：

前沿思维链大语言模型能以合理的一致性遵循约 150-200 条指令。 较小的模型比较大的模型能关注的指令更少，非思维链模型比思维链模型能关注的指令更少。
较小模型的性能下降速度要快得多。具体来说，随着指令数量的增加，较小模型往往表现出指令遵循性能的指数级衰减，而较大的前沿思维链模型则表现出线性衰减（见下文）。因此，我们建议不要将较小的模型用于多步骤任务或复杂的实现计划。
大语言模型倾向于关注提示词（prompt）边缘的指令：也就是位于最开头（Claude Code 系统消息和 CLAUDE.md）和最末尾（最近的用户消息）。
随着指令数量增加，指令遵循质量会均匀下降。这意味着当你给大语言模型更多指令时，它不仅仅是忽略较新的（「文件中较靠后」）指令——它开始均匀地忽略所有指令。

因此，这意味着你的 CLAUDE.md 文件应包含尽可能少的指令——最好只包含那些普遍适用于你的任务的指令。

③拆分CLAUDE.md——渐进式披露

显然，在大型项目中，编写一个涵盖你想让 Claude 知道的所有内容的简洁 CLAUDE.md 文件可能具有挑战性。

为了解决这个问题，我们可以利用渐进式披露原则，确保 Claude 仅在需要时才看到特定于任务或项目的指令。

所谓渐进式披露，就是指一种信息或功能分层呈现的方法，通过按需展示内容或能力，减少用户或系统的认知负担，实现高效交互和可控操作。关于项目结构可以参考下面这张图

所以，我们应该将特定于某项任务的指令保存在该项目所在文件夹的单独的 Markdown 文件中，而不是将关于构建项目、运行测试、代码约定或其他重要上下文的所有不同指令都包含在 CLAUDE.md 文件中。

我们要将Markdown文件分开管理，一个是在项目根目录的全局CLAUDE.md，比如D:\ClaudeCode_Work_Space\CLAUDE.md，只要你打开Claude Code，无论你进入的是哪个项目，它都会被自动阅读并遵守，其他则是具体文件所在文件夹的CLAUDE.md，它只在你打开这个项目的时候才会被加载。它解决的是这个具体的项目要怎么干，有什么特殊约定这一层的问题。

④不！要！使！用！`/init` 或自动生成你的 `CLAUDE.md`

Claude Code 和其他带有 OpenCode 的工具套件都提供了自动生成 CLAUDE.md 文件（或 AGENTS.md）的方法。

因为 CLAUDE.md 会进入与 Claude Code 的每一次会话，它便成为了整个工作流程中影响力最大的关键节点之一，这种影响可能是正面的也可能是负面的，完全取决于如何运用它。

时刻谨记， CLAUDE.md 文件影响你工作流程的每一个阶段以及由其生成的每一个工件。因此，我们认为你应该花时间非常仔细地思考其中的每一行，一个糟糕的CLAUDE.md会导致Claude Code在每一次修改中向着糟糕的方向改进，最终导致代码质量恶化。

为什么Claude init不行？如果一件事，你不跟他说，模型看一遍codebase就能写出来，那说明这事它本来就会，根本不用再说一遍，我们需要写入CLAUDE.md的都是反它的直觉的。

⑤Summarization

大语言模型是上下文学习者（in-context learners），而不是Linter，不要用大语言模型来做Linter的工作！

CLAUDE.md应保证：

包含What,Why,How
遵循少即是多原则
使用渐进式披露
不要让模型去做Linter的工作
精心打磨，不断修改CLAUDE.md，不要自动生成