最近很多朋友都在問我,能不能出一期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。
所以我常年說,能一步到位就一步到位,我當(dāng)然知道現(xiàn)在比如什么OpenClaw、Hermers Agent等等非常火,但是我還是依然會(huì)建議你使用Claude Code,即使用不了Claude的原生模型,你搭配個(gè)國(guó)產(chǎn)模型,效果也依然很好。
而且也不用擔(dān)心封號(hào),不需要外國(guó)手機(jī)號(hào),visa卡,甚至都可以不上魔法。
所以今天,就來一篇Claude Code的從0入門全面新手教程,并且盡可能讓所有的朋友,都可以用上,Windows和Mac,有魔法沒魔法的操作,我都準(zhǔn)備了,大家按需看對(duì)應(yīng)的部分就行。
下面的安裝流程,是我一整個(gè)周末,跟我們小伙伴一起,折騰了五六臺(tái)電腦反復(fù)安裝卸載試出來的。
比如有些場(chǎng)景,像沒有魔法,其實(shí)還有其他安裝方式,像npm,又或者直接curl國(guó)內(nèi)鏡像源,這些辦法其實(shí)也能用,但我在不同電腦上測(cè)試的時(shí)候并不夠穩(wěn)定。
所以最后,我選了在我看來最簡(jiǎn)單,并且在極度原始的電腦上測(cè)試也不容易翻車的方式。
只希望大家跟著文章,都能順利地用上世界上最牛逼的Agent框架。
我會(huì)把每一步都給大家說得盡量詳細(xì)清楚,可能會(huì)有些啰嗦,大家別介意。
好了,我們直接開始。
一. Claude Code 安裝
1. Mac
先來看Mac,Windows同學(xué)可以直接跳過Mac這一趴去下面找Windows的教程。
我們先在App中找到終端打開。
![]()
我們先來安裝一下今天的主角,Claude Code。
這里我給自己的電腦新建了一個(gè)全新的macOS賬號(hào),基本等同于空電腦,方便演示。
先聊有魔法的情況。
命令就一句話。
curl -fsSL https://claude.ai/install.sh | bash我們?cè)诮K端粘貼這條命令后,按下回車。
![]()
等一會(huì),就能看到安裝成功。
![]()
雖然裝好了,但這里有可能他也會(huì)給出一個(gè)提示。
![]()
意思是說,Claude Code已經(jīng)裝好了,但Claude Code的安裝位置~/.local/bin還沒加到你的PATH環(huán)境變量里,所以你直接敲claude可能找不到這個(gè)命令。
還說要解決這個(gè)問題,請(qǐng)執(zhí)行下面那條命令巴拉巴拉。
看不懂也沒關(guān)系,我們就按他說的,把他給出的那一長(zhǎng)串echo命令復(fù)制到終端里,回車跑一下。
然后輸入claude --version,有版本號(hào)輸出,就表示安裝成功了。
![]()
有魔法的情況非常簡(jiǎn)單,但是我也知道,很多同學(xué)是沒有魔法的。
所以,如果沒有魔法的話,我們可以通過homebrew安裝。
Homebrew是macOS上最流行的命令行包管理器,作用是讓你用一條命令就能安裝、更新、卸載各種軟件和開發(fā)工具。
這里我借了一臺(tái)我們經(jīng)紀(jì)小伙伴的新電腦,沒有魔法,環(huán)境非常干凈。
我們先來裝一下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來管理Mac包了。
接著,用下面這行命令來裝Claude code。
brew install --cask claude-code![]()
這里的安裝速度有點(diǎn)慢,大家可以先去抹灰魚,忙完了回來看。
等安裝成功出現(xiàn),我們?cè)诮K端輸入claude,就能看到小螃蟹了。
![]()
但是這里,會(huì)顯示用不了,可以先不管,一會(huì)我們會(huì)教大家怎么接上模型。
mac說完了,然后在單獨(dú)說一下Windows,會(huì)稍微有一點(diǎn)點(diǎn)不一樣,安裝好的Mac同學(xué)可以直接跳過這一趴。
2. Windows
再來看Windows。
我這里拿了一臺(tái)剛刷機(jī)過的Windows來裝了一遍。
因?yàn)镃laude Code在Windows上內(nèi)部是用Git Bash來執(zhí)行命令的,所以要想在Windows上用Claude Code,必須先把Git安裝上。
所以第一步,我們先把Git裝上。
已經(jīng)裝好的朋友可以跳過這一趴。
用WinGet來裝,這個(gè)東西是Windows官方的包管理器,可以理解成Windows版本的Homebrew。
我們?cè)谌蝿?wù)欄搜索終端打開。
![]()
粘貼下面的命令到終端,這里安裝的時(shí)候不開魔法速度會(huì)快很多。
winget install Git.Git跑完就會(huì)顯示成功安裝了。
![]()
Git裝好了之后,老規(guī)矩,我們先說有魔法的情況。
有魔法的朋友,我們還是用他官方的原生安裝命令。
粘貼命令到終端。
irm https://claude.ai/install.ps1 | iex![]()
等一會(huì)就安裝好了。
![]()
非常便捷。
如果沒魔法的話,我們就得使用WinGet來安裝。
在終端中運(yùn)行這行命令。
winget install Anthropic.ClaudeCode![]()
等他安裝成功后,同樣可以輸入claude,就能看到已經(jīng)安裝成功了。
![]()
到這一步,從道理上講,我們?cè)诮K端里輸入claude,就能進(jìn)到Claude Code頁面了。
但是。
我們這里光裝了框架,還沒給他安腦子,所以還沒法用。
那接下來,我們就需要把他的腦子接上。
二. 接模型
如果是有Claude賬號(hào)的,直接登錄就行了,這里我就不細(xì)說了。
因?yàn)槔碚撋夏阋呀?jīng)有Claude賬號(hào)了,你也不會(huì)來看這個(gè)保姆教程。。。
所以,為了讓國(guó)內(nèi)所有的小伙伴都能用上,這里我用國(guó)產(chǎn)模型GLM-5.1來舉例子。
因?yàn)镚LM-5.1是目前我用下來覺得國(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這塊,智譜官方有提供一句話命令來安裝,特別簡(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一樣,就不分開說了。
裝好后,我們打開他。
一進(jìn)去能看到,這玩意其實(shí)不僅適用于Claude Code,Codex、小龍蝦這些都能用。
因?yàn)槲覀冞@里還沒配置,所以目前只有Claude官方的模型配置。
在Claude那一欄下面,我們點(diǎn)右上角的加號(hào),新增模型配置。
![]()
然后選擇我們想要使用的模型,這里我選的是GLM國(guó)內(nèi)版。
![]()
接著要填的就兩部分,API key(這塊如果不知道什么是API Key的,可以去直接問你能用上的任何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ù)自己的喜好來就好。選中回車。
以后想改,在Claude Code里運(yùn)行/theme就行。
![]()
接著是安全提示。
![]()
就兩點(diǎn)。
一個(gè)是Claude會(huì)犯錯(cuò),它生成的代碼、它要執(zhí)行的命令,你都應(yīng)該過一眼再放行。
一個(gè)是只在你信任的代碼庫里用Claude Code,避免提示詞注入攻擊。
我們直接回車進(jìn)入下一步。
是問我們是否使用Claude Code的終端設(shè)置。
![]()
這里,直接使用他推薦的終端設(shè)置就可以。
其實(shí)就是他想幫你啟用兩個(gè)東西。
快捷鍵實(shí)現(xiàn)在終端里換行。
另一個(gè)是Visual bell,視覺提示。
也就是Claude跑完任務(wù)或者需要你確認(rèn)的時(shí)候,終端窗口的頁面會(huì)閃一下,Dock圖標(biāo)會(huì)彈跳一下,提醒你。
最后一步,就是和你確認(rèn)當(dāng)前所在目錄,是否可以信任。
![]()
這里選擇是,然后回車。
我們就終于來到接入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。
我自己就分了一下目錄,文稿是我拿來做知識(shí)創(chuàng)作了。
![]()
還有一個(gè)code文件夾,下面都是我自己開發(fā)的各種各樣的產(chǎn)品。
![]()
在命令行中對(duì)著一個(gè)命令行啟動(dòng)Claude Code也特別簡(jiǎn)單。
就是cd命令,這塊Mac和Windows是一樣的。
比如我要進(jìn)入知識(shí)庫這個(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í)上下文污染更小,也更專注,換句話說,就是更聰明。
四. 寫CLAUDE.md
學(xué)會(huì)啟動(dòng)之后,其實(shí)你就可以正式的對(duì)話了,隨便讓他干活就行。
但還有個(gè)規(guī)范和你在深度使用之前,有一個(gè)很重要的習(xí)慣,我覺得是需要讓你先設(shè)置的,不要再踩我走過的老坑,先定好你的CLAUDE.md文件。
而在我看來,這甚至是學(xué)會(huì)啟動(dòng)Claude Code之后,第一件該做的事。
在上具體寫法之前,我還是先和大家聊一聊CLAUDE.md是個(gè)啥。
這個(gè)東西,它不簡(jiǎn)單是一份文件,它是一個(gè)從上往下分層穿透的約束體系。
就像我之前用過的這張圖。
![]()
剛裝完,我們應(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ī)范。
它可以解決的是你是誰、你做事的原則、你希望他用什么方式跟你協(xié)作這一層的問題。
而項(xiàng)目級(jí)CLAUDE.md,放在每個(gè)項(xiàng)目的根目錄下,路徑就是項(xiàng)目目錄/CLAUDE.md。
![]()
它只在你打開這個(gè)項(xiàng)目的時(shí)候才會(huì)被加載。
它解決的是這個(gè)具體的項(xiàng)目要怎么干,有什么特殊約定這一層的問題。
我們先來聊全局CLAUDE.md,也是第一個(gè)需要定好的東西,但是到底該往CLAUDE.md里寫什么、怎么寫、寫多長(zhǎng)、放哪里,很多人其實(shí)不清楚,對(duì)于非開發(fā)者來說,我也分享一下我的經(jīng)驗(yàn)。
關(guān)于長(zhǎng)度,CLAUDE.md不是越長(zhǎng)越好,反而是要盡量精簡(jiǎn)。
你的CLAUDE.md寫得太長(zhǎng),后半段的內(nèi)容它會(huì)直接忽略掉。
具體的紅線數(shù)字是這樣的,超過80行,Claude開始遺漏部分內(nèi)容,最多最多,一定不要超過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來做開發(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),然后愉快的開始說出我自己的需求幫助我coding,那有了這個(gè)CLAUDE.md文件之后,他就會(huì)自己判斷這是不是一個(gè)新產(chǎn)品,如果是的話,那就直接幫我新建一個(gè)文件夾開始做,這樣整個(gè)文件管理,就會(huì)變得井井有條了。
![]()
而這個(gè)文件其實(shí)也完全不用你自己寫,你就直接打開那個(gè)文件夾,然后和Claude Code聊就行,你直接把你的需求,和你在意的事情,和他探討,讓他給你寫一份就OK了。
![]()
我自己這幾天也在好好跟我的Claude Code制定各種規(guī)范,整理我之前遺留下來的各種屎山。
那如果你的電腦上現(xiàn)在還什么都沒有的話,那就更方便了。
這也是我一直強(qiáng)調(diào)約束先行、規(guī)范先行的原因之一。
約束定好了,那就真的可以開始玩起來了。
而skills,plugins,常用命令、功能這些。
我這里就不展開了,我也寫過了很多相關(guān)的文章,感興趣的小伙伴可以直接去對(duì)應(yīng)著搜索關(guān)鍵詞就行。
![]()
終于把這篇拖了很久很久的保姆級(jí)Claude Code教程寫完了。
Claude Code,就是我推薦你的當(dāng)前AI版本的畢業(yè)工具。
你根本無需使用各種亂七八糟的那些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
特別聲明:以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布,本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.