最近很多朋友都在問(wèn)我，能不能出一期Claude Code的小白教程。

他們也想用上這個(gè)世界上最牛逼的Agent產(chǎn)品。

而且其實(shí)很多人不太知道，Agent產(chǎn)品一般是Agent框架+模型組成的，Claude的模型國(guó)內(nèi)確實(shí)會(huì)封，會(huì)非常的難搞，我也沒有任何辦法教大家弄。

但Claude Code不會(huì)被封，也不會(huì)用不了，因?yàn)檫@玩意其實(shí)就是個(gè)Agent框架，搭配任何模型都可以使用。

雖然Anthropics確實(shí)很狗，天天封號(hào)，又搞實(shí)名認(rèn)證，但我依然不得不承認(rèn)，這個(gè)世界上目前最好的Agent框架，還是Claude Code。

所以我常年說(shuō)，能一步到位就一步到位，我當(dāng)然知道現(xiàn)在比如什么OpenClaw、Hermers Agent等等非?；?，但是我還是依然會(huì)建議你使用Claude Code，即使用不了Claude的原生模型，你搭配個(gè)國(guó)產(chǎn)模型，效果也依然很好。

而且也不用擔(dān)心封號(hào)，不需要外國(guó)手機(jī)號(hào)，visa卡，甚至都可以不上魔法。

所以今天，就來(lái)一篇Claude Code的從0入門全面新手教程，并且盡可能讓所有的朋友，都可以用上，Windows和Mac，有魔法沒魔法的操作，我都準(zhǔn)備了，大家按需看對(duì)應(yīng)的部分就行。

下面的安裝流程，是我一整個(gè)周末，跟我們小伙伴一起，折騰了五六臺(tái)電腦反復(fù)安裝卸載試出來(lái)的。

比如有些場(chǎng)景，像沒有魔法，其實(shí)還有其他安裝方式，像npm，又或者直接curl國(guó)內(nèi)鏡像源，這些辦法其實(shí)也能用，但我在不同電腦上測(cè)試的時(shí)候并不夠穩(wěn)定。

所以最后，我選了在我看來(lái)最簡(jiǎn)單，并且在極度原始的電腦上測(cè)試也不容易翻車的方式。

只希望大家跟著文章，都能順利地用上世界上最牛逼的Agent框架。

我會(huì)把每一步都給大家說(shuō)得盡量詳細(xì)清楚，可能會(huì)有些啰嗦，大家別介意。

好了，我們直接開始。

一. Claude Code 安裝

1. Mac

先來(lái)看Mac，Windows同學(xué)可以直接跳過(guò)Mac這一趴去下面找Windows的教程。

我們先在App中找到終端打開。

我們先來(lái)安裝一下今天的主角，Claude Code。

這里我給自己的電腦新建了一個(gè)全新的macOS賬號(hào)，基本等同于空電腦，方便演示。

先聊有魔法的情況。

命令就一句話。

curl -fsSL https://claude.ai/install.sh | bash

我們?cè)诮K端粘貼這條命令后，按下回車。

等一會(huì)，就能看到安裝成功。

雖然裝好了，但這里有可能他也會(huì)給出一個(gè)提示。

意思是說(shuō)，Claude Code已經(jīng)裝好了，但Claude Code的安裝位置~/.local/bin還沒加到你的PATH環(huán)境變量里，所以你直接敲claude可能找不到這個(gè)命令。

還說(shuō)要解決這個(gè)問(wèn)題，請(qǐng)執(zhí)行下面那條命令巴拉巴拉。

看不懂也沒關(guān)系，我們就按他說(shuō)的，把他給出的那一長(zhǎng)串echo命令復(fù)制到終端里，回車跑一下。

然后輸入claude --version，有版本號(hào)輸出，就表示安裝成功了。

有魔法的情況非常簡(jiǎn)單，但是我也知道，很多同學(xué)是沒有魔法的。

所以，如果沒有魔法的話，我們可以通過(guò)homebrew安裝。

Homebrew是macOS上最流行的命令行包管理器，作用是讓你用一條命令就能安裝、更新、卸載各種軟件和開發(fā)工具。

這里我借了一臺(tái)我們經(jīng)紀(jì)小伙伴的新電腦，沒有魔法，環(huán)境非常干凈。

我們先來(lái)裝一下brew，看著可能會(huì)有點(diǎn)復(fù)雜，但是其實(shí)你跟著做，特別簡(jiǎn)單。

把下面這行命令粘貼到命令行，回車運(yùn)行。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

看到提示之后，我們直接回車。

然后他就會(huì)跑啊跑啊。

耐心等待幾分鐘，等他跑完，出現(xiàn)安裝成功就裝好了。

下一步，我們需要把homebrew加到路徑變量里面去，這樣我們?cè)诮K端使用homebrew的時(shí)候他才能找到命令。

把這幾行命令粘貼到終端里跑一遍。

這樣，我們就可以使用homebrew來(lái)管理Mac包了。

接著，用下面這行命令來(lái)裝Claude code。

brew install --cask claude-code

這里的安裝速度有點(diǎn)慢，大家可以先去抹灰魚，忙完了回來(lái)看。

等安裝成功出現(xiàn)，我們?cè)诮K端輸入claude，就能看到小螃蟹了。

但是這里，會(huì)顯示用不了，可以先不管，一會(huì)我們會(huì)教大家怎么接上模型。

mac說(shuō)完了，然后在單獨(dú)說(shuō)一下Windows，會(huì)稍微有一點(diǎn)點(diǎn)不一樣，安裝好的Mac同學(xué)可以直接跳過(guò)這一趴。

2. Windows

再來(lái)看Windows。

我這里拿了一臺(tái)剛刷機(jī)過(guò)的Windows來(lái)裝了一遍。

因?yàn)镃laude Code在Windows上內(nèi)部是用Git Bash來(lái)執(zhí)行命令的，所以要想在Windows上用Claude Code，必須先把Git安裝上。

所以第一步，我們先把Git裝上。

已經(jīng)裝好的朋友可以跳過(guò)這一趴。

用WinGet來(lái)裝，這個(gè)東西是Windows官方的包管理器，可以理解成Windows版本的Homebrew。

我們?cè)谌蝿?wù)欄搜索終端打開。

粘貼下面的命令到終端，這里安裝的時(shí)候不開魔法速度會(huì)快很多。

winget install Git.Git

跑完就會(huì)顯示成功安裝了。

Git裝好了之后，老規(guī)矩，我們先說(shuō)有魔法的情況。

有魔法的朋友，我們還是用他官方的原生安裝命令。

粘貼命令到終端。

irm https://claude.ai/install.ps1 | iex

等一會(huì)就安裝好了。

非常便捷。

如果沒魔法的話，我們就得使用WinGet來(lái)安裝。

在終端中運(yùn)行這行命令。

winget install Anthropic.ClaudeCode

等他安裝成功后，同樣可以輸入claude，就能看到已經(jīng)安裝成功了。

到這一步，從道理上講，我們?cè)诮K端里輸入claude，就能進(jìn)到Claude Code頁(yè)面了。

但是。

我們這里光裝了框架，還沒給他安腦子，所以還沒法用。

那接下來(lái)，我們就需要把他的腦子接上。

二. 接模型

如果是有Claude賬號(hào)的，直接登錄就行了，這里我就不細(xì)說(shuō)了。

因?yàn)槔碚撋夏阋呀?jīng)有Claude賬號(hào)了，你也不會(huì)來(lái)看這個(gè)保姆教程。。。

所以，為了讓國(guó)內(nèi)所有的小伙伴都能用上，這里我用國(guó)產(chǎn)模型GLM-5.1來(lái)舉例子。

因?yàn)镚LM-5.1是目前我用下來(lái)覺得國(guó)內(nèi)效果最好最接近Claude Opus 4.6體驗(yàn)的。

當(dāng)然，你要是沒搶到他們的coding plan的話，用MiniMax M2.7和K2.5也都不錯(cuò)，K2.6 code應(yīng)該也快出了，感覺kimi也會(huì)有一波飛躍，推薦大家可以蹲一下。

然后GLM5.1這塊，智譜官方有提供一句話命令來(lái)安裝，特別簡(jiǎn)單。

npx @z_ai/coding-helper

但這里，為了方便大家也能接入其他模型并且隨意切換，所以，我們教大家一個(gè)更通用的方法，也就是，用CC Switch。

還是分Mac和Windows。

1. Mac

在Mac上，他的安裝就兩行命令。

brew install --cask cc-switch

在終端粘貼，回車運(yùn)行。

等他裝好就成了。

2. Windows

Windows的話，推薦直接去下面的鏈接下載安裝包。

https://github.com/farion1231/cc-switch/releases

如果你進(jìn)不去github，那我也給大家準(zhǔn)備好了本地安裝包，你對(duì)著公眾號(hào)后臺(tái)回復(fù)cc就會(huì)自動(dòng)給你發(fā)下載鏈接了。

下載后雙擊運(yùn)行，然后可以一路next到底，就安裝好了。

后面的操作Mac和Windows一樣，就不分開說(shuō)了。

裝好后，我們打開他。

一進(jìn)去能看到，這玩意其實(shí)不僅適用于Claude Code，Codex、小龍蝦這些都能用。

因?yàn)槲覀冞@里還沒配置，所以目前只有Claude官方的模型配置。

在Claude那一欄下面，我們點(diǎn)右上角的加號(hào)，新增模型配置。

然后選擇我們想要使用的模型，這里我選的是GLM國(guó)內(nèi)版。

接著要填的就兩部分，API key（這塊如果不知道什么是API Key的，可以去直接問(wèn)你能用上的任何AI，他們都會(huì)幫你解決）和模型配置，其他的他都會(huì)自動(dòng)幫我們填好。

填好之后，我們點(diǎn)擊右下角的添加就行.

他就會(huì)切換到我們配置的模型上。

到這一步，Claude Code的安裝和GLM-5.1的接入就完成了。

三. 啟動(dòng)Claude Code

我們回到終端，輸入claude，回車。

就可以正常啟動(dòng)claude code了。

第一次使用，會(huì)先有一些初始化設(shè)置。

比如顏色模式，模式下面有代碼預(yù)覽，大家根據(jù)自己的喜好來(lái)就好。選中回車。

以后想改，在Claude Code里運(yùn)行/theme就行。

接著是安全提示。

就兩點(diǎn)。

一個(gè)是Claude會(huì)犯錯(cuò)，它生成的代碼、它要執(zhí)行的命令，你都應(yīng)該過(guò)一眼再放行。

一個(gè)是只在你信任的代碼庫(kù)里用Claude Code，避免提示詞注入攻擊。

我們直接回車進(jìn)入下一步。

是問(wèn)我們是否使用Claude Code的終端設(shè)置。

這里，直接使用他推薦的終端設(shè)置就可以。

其實(shí)就是他想幫你啟用兩個(gè)東西。

快捷鍵實(shí)現(xiàn)在終端里換行。

另一個(gè)是Visual bell，視覺提示。

也就是Claude跑完任務(wù)或者需要你確認(rèn)的時(shí)候，終端窗口的頁(yè)面會(huì)閃一下，Dock圖標(biāo)會(huì)彈跳一下，提醒你。

最后一步，就是和你確認(rèn)當(dāng)前所在目錄，是否可以信任。

這里選擇是，然后回車。

我們就終于來(lái)到接入GLM-5.1的Claude Code的對(duì)話界面了。

后續(xù)想要切換模型，在CC Switch里面配置好，在Claude Code里面用/model切就行。

至此，所有的安裝接入操作就完成了。

后續(xù)用的話，直接在終端輸claude就行了。

這里推薦大家用下面這行命令，特別是開發(fā)的時(shí)候，不然點(diǎn)各種allow會(huì)點(diǎn)到你懷疑人生。

claude --dangerously-skip-permissions

然后我們啟動(dòng)的時(shí)候，因?yàn)樯舷挛脑O(shè)計(jì)，為了讓他有約束，更加的專注，所以我們是需要對(duì)著一個(gè)文件夾進(jìn)行啟動(dòng)的，而不是直接在根目錄啟動(dòng)Claude Code。

我自己就分了一下目錄，文稿是我拿來(lái)做知識(shí)創(chuàng)作了。

還有一個(gè)code文件夾，下面都是我自己開發(fā)的各種各樣的產(chǎn)品。

在命令行中對(duì)著一個(gè)命令行啟動(dòng)Claude Code也特別簡(jiǎn)單。

就是cd命令，這塊Mac和Windows是一樣的。

比如我要進(jìn)入知識(shí)庫(kù)這個(gè)文件夾進(jìn)行創(chuàng)作。

那就打開終端，輸入cd，然后一定要記得按一下空格，再把你的文件夾，直接拖進(jìn)去。

按下回車，就算是進(jìn)入這個(gè)文件夾了。

然后這個(gè)時(shí)候再用命令啟動(dòng)Claude Code就可以。

你就會(huì)進(jìn)入到這個(gè)文件夾下，它默認(rèn)就只在這個(gè)文件夾下工作，默認(rèn)讀取你這個(gè)文件夾下的所有文件。

這樣其實(shí)上下文污染更小，也更專注，換句話說(shuō)，就是更聰明。

四. 寫CLAUDE.md

學(xué)會(huì)啟動(dòng)之后，其實(shí)你就可以正式的對(duì)話了，隨便讓他干活就行。

但還有個(gè)規(guī)范和你在深度使用之前，有一個(gè)很重要的習(xí)慣，我覺得是需要讓你先設(shè)置的，不要再踩我走過(guò)的老坑，先定好你的CLAUDE.md文件。

而在我看來(lái)，這甚至是學(xué)會(huì)啟動(dòng)Claude Code之后，第一件該做的事。

在上具體寫法之前，我還是先和大家聊一聊CLAUDE.md是個(gè)啥。

這個(gè)東西，它不簡(jiǎn)單是一份文件，它是一個(gè)從上往下分層穿透的約束體系。

就像我之前用過(guò)的這張圖。

剛裝完，我們應(yīng)該去管的兩層，就是全局CLAUDE.md和項(xiàng)目CLAUDE.md。

全局CLAUDE.md，放在用戶總目錄的Claude Code根目錄下面，~/.claude/CLAUDE.md。

只要你打開Claude Code，不管你進(jìn)的是哪個(gè)項(xiàng)目，它都會(huì)被自動(dòng)加載和遵守。

這是他的頂層規(guī)范。

它可以解決的是你是誰(shuí)、你做事的原則、你希望他用什么方式跟你協(xié)作這一層的問(wèn)題。

而項(xiàng)目級(jí)CLAUDE.md，放在每個(gè)項(xiàng)目的根目錄下，路徑就是項(xiàng)目目錄/CLAUDE.md。

它只在你打開這個(gè)項(xiàng)目的時(shí)候才會(huì)被加載。

它解決的是這個(gè)具體的項(xiàng)目要怎么干，有什么特殊約定這一層的問(wèn)題。

我們先來(lái)聊全局CLAUDE.md，也是第一個(gè)需要定好的東西，但是到底該往CLAUDE.md里寫什么、怎么寫、寫多長(zhǎng)、放哪里，很多人其實(shí)不清楚，對(duì)于非開發(fā)者來(lái)說(shuō)，我也分享一下我的經(jīng)驗(yàn)。

關(guān)于長(zhǎng)度，CLAUDE.md不是越長(zhǎng)越好，反而是要盡量精簡(jiǎn)。

你的CLAUDE.md寫得太長(zhǎng)，后半段的內(nèi)容它會(huì)直接忽略掉。

具體的紅線數(shù)字是這樣的，超過(guò)80行，Claude開始遺漏部分內(nèi)容，最多最多，一定不要超過(guò)200行。

之前的一篇文章，我也給大家看了我的全局CLAUDE.md文件里面都是哪些內(nèi)容。

在我的內(nèi)容的基礎(chǔ)上，我又迭代了一下，為大家準(zhǔn)備了一份模板。

里面都是一些我覺得一份不錯(cuò)的全局CLAUDE.md應(yīng)該有的東西。

大家只需要在關(guān)于我里面，寫上自己的內(nèi)容，其他基本都是可以直接復(fù)用的。

- 大改動(dòng)前先在 Plan Mode 出方案，我確認(rèn)后再動(dòng)手

一共30多行，分成六個(gè)部分。

這六個(gè)塊都有一個(gè)共同特征，就是跨項(xiàng)目通用。

全局的CLAUDE.md定好了，我們頂層的規(guī)范就有了。

那至于下一層，項(xiàng)目CLAUDE.md。

拿我自己舉例。

我主要用Claude Code來(lái)做開發(fā)和知識(shí)管理。

比如我的code/my目錄下就有一個(gè)CLAUDE.md，這個(gè)的作用，主要就是my文件夾下，經(jīng)常coding的都是一些可能一次性的、或者我實(shí)驗(yàn)性質(zhì)的亂七八糟的東西，其實(shí)都非常的小，所以我真的懶得每次都在my下新建一個(gè)文件夾。

所以我現(xiàn)在常用的做法，就是直接cd到my文件夾啟動(dòng)，然后愉快的開始說(shuō)出我自己的需求幫助我coding，那有了這個(gè)CLAUDE.md文件之后，他就會(huì)自己判斷這是不是一個(gè)新產(chǎn)品，如果是的話，那就直接幫我新建一個(gè)文件夾開始做，這樣整個(gè)文件管理，就會(huì)變得井井有條了。

而這個(gè)文件其實(shí)也完全不用你自己寫，你就直接打開那個(gè)文件夾，然后和Claude Code聊就行，你直接把你的需求，和你在意的事情，和他探討，讓他給你寫一份就OK了。

我自己這幾天也在好好跟我的Claude Code制定各種規(guī)范，整理我之前遺留下來(lái)的各種屎山。

那如果你的電腦上現(xiàn)在還什么都沒有的話，那就更方便了。

這也是我一直強(qiáng)調(diào)約束先行、規(guī)范先行的原因之一。

約束定好了，那就真的可以開始玩起來(lái)了。

而skills，plugins，常用命令、功能這些。

我這里就不展開了，我也寫過(guò)了很多相關(guān)的文章，感興趣的小伙伴可以直接去對(duì)應(yīng)著搜索關(guān)鍵詞就行。

終于把這篇拖了很久很久的保姆級(jí)Claude Code教程寫完了。

Claude Code，就是我推薦你的當(dāng)前AI版本的畢業(yè)工具。

你根本無(wú)需使用各種亂七八糟的那些Agent，用好Claude Code，你就真的能感受到，什么是最牛逼的Agent了。

希望大家都能愉快創(chuàng)造。

做出這個(gè)時(shí)代。

屬于你自己的作品。

以上，既然看到這里了，如果覺得不錯(cuò)，隨手點(diǎn)個(gè)贊、在看、轉(zhuǎn)發(fā)三連吧，如果想第一時(shí)間收到推送，也可以給我個(gè)星標(biāo)?～謝謝你看我的文章，我們，下次再見。

>/ 作者：卡茲克，tashi

>/ 投稿或爆料，請(qǐng)聯(lián)系郵箱：wzglyay@virxact.com