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

他們也想用上這個世界上最牛逼的Agent產品。

而且其實很多人不太知道，Agent產品一般是Agent框架+模型組成的，Claude的模型國內確實會封，會非常的難搞，我也沒有任何辦法教大家弄。

但Claude Code不會被封，也不會用不了，因為這玩意其實就是個Agent框架，搭配任何模型都可以使用。

雖然Anthropics確實很狗，天天封號，又搞實名認證，但我依然不得不承認，這個世界上目前最好的Agent框架，還是Claude Code。

所以我常年說，能一步到位就一步到位，我當然知道現在比如什么OpenClaw、Hermers Agent等等非常火，但是我還是依然會建議你使用Claude Code，即使用不了Claude的原生模型，你搭配個國產模型，效果也依然很好。

而且也不用擔心封號，不需要外國手機號，visa卡，甚至都可以不上魔法。

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

下面的安裝流程，是我一整個周末，跟我們小伙伴一起，折騰了五六臺電腦反復安裝卸載試出來的。

比如有些場景，像沒有魔法，其實還有其他安裝方式，像npm，又或者直接curl國內鏡像源，這些辦法其實也能用，但我在不同電腦上測試的時候并不夠穩定。

所以最后，我選了在我看來最簡單，并且在極度原始的電腦上測試也不容易翻車的方式。

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

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

好了，我們直接開始。

一. Claude Code 安裝

1. Mac

先來看Mac，Windows同學可以直接跳過Mac這一趴去下面找Windows的教程。

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

我們先來安裝一下今天的主角，Claude Code。

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

先聊有魔法的情況。

命令就一句話。

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

我們在終端粘貼這條命令后，按下回車。

等一會，就能看到安裝成功。

雖然裝好了，但這里有可能他也會給出一個提示。

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

還說要解決這個問題，請執行下面那條命令巴拉巴拉。

看不懂也沒關系，我們就按他說的，把他給出的那一長串echo命令復制到終端里，回車跑一下。

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

有魔法的情況非常簡單，但是我也知道，很多同學是沒有魔法的。

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

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

這里我借了一臺我們經紀小伙伴的新電腦，沒有魔法，環境非常干凈。

我們先來裝一下brew，看著可能會有點復雜，但是其實你跟著做，特別簡單。

把下面這行命令粘貼到命令行，回車運行。

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

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

然后他就會跑啊跑啊。

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

下一步，我們需要把homebrew加到路徑變量里面去，這樣我們在終端使用homebrew的時候他才能找到命令。

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

這樣，我們就可以使用homebrew來管理Mac包了。

接著，用下面這行命令來裝Claude code。

brew install --cask claude-code

這里的安裝速度有點慢，大家可以先去抹灰魚，忙完了回來看。

等安裝成功出現，我們在終端輸入claude，就能看到小螃蟹了。

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

mac說完了，然后在單獨說一下Windows，會稍微有一點點不一樣，安裝好的Mac同學可以直接跳過這一趴。

2. Windows

再來看Windows。

我這里拿了一臺剛刷機過的Windows來裝了一遍。

因為Claude Code在Windows上內部是用Git Bash來執行命令的，所以要想在Windows上用Claude Code，必須先把Git安裝上。

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

已經裝好的朋友可以跳過這一趴。

用WinGet來裝，這個東西是Windows官方的包管理器，可以理解成Windows版本的Homebrew。

我們在任務欄搜索終端打開。

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

winget install Git.Git

跑完就會顯示成功安裝了。

Git裝好了之后，老規矩，我們先說有魔法的情況。

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

粘貼命令到終端。

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

等一會就安裝好了。

非常便捷。

如果沒魔法的話，我們就得使用WinGet來安裝。

在終端中運行這行命令。

winget install Anthropic.ClaudeCode

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

到這一步，從道理上講，我們在終端里輸入claude，就能進到Claude Code頁面了。

但是。

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

那接下來，我們就需要把他的腦子接上。

二. 接模型

如果是有Claude賬號的，直接登錄就行了，這里我就不細說了。

因為理論上你已經有Claude賬號了，你也不會來看這個保姆教程。。。

所以，為了讓國內所有的小伙伴都能用上，這里我用國產模型GLM-5.1來舉例子。

因為GLM-5.1是目前我用下來覺得國內效果最好最接近Claude Opus 4.6體驗的。

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

然后GLM5.1這塊，智譜官方有提供一句話命令來安裝，特別簡單。

npx @z_ai/coding-helper

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

還是分Mac和Windows。

1. Mac

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

brew install --cask cc-switch

在終端粘貼，回車運行。

等他裝好就成了。

2. Windows

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

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

如果你進不去github，那我也給大家準備好了本地安裝包，你對著公眾號后臺回復cc就會自動給你發下載鏈接了。

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

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

裝好后，我們打開他。

一進去能看到，這玩意其實不僅適用于Claude Code，Codex、小龍蝦這些都能用。

因為我們這里還沒配置，所以目前只有Claude官方的模型配置。

在Claude那一欄下面，我們點右上角的加號，新增模型配置。

然后選擇我們想要使用的模型，這里我選的是GLM國內版。

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

填好之后，我們點擊右下角的添加就行.

他就會切換到我們配置的模型上。

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

三. 啟動Claude Code

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

就可以正常啟動claude code了。

第一次使用，會先有一些初始化設置。

比如顏色模式，模式下面有代碼預覽，大家根據自己的喜好來就好。選中回車。

以后想改，在Claude Code里運行/theme就行。

接著是安全提示。

就兩點。

一個是Claude會犯錯，它生成的代碼、它要執行的命令，你都應該過一眼再放行。

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

我們直接回車進入下一步。

是問我們是否使用Claude Code的終端設置。

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

其實就是他想幫你啟用兩個東西。

快捷鍵實現在終端里換行。

另一個是Visual bell，視覺提示。

也就是Claude跑完任務或者需要你確認的時候，終端窗口的頁面會閃一下，Dock圖標會彈跳一下，提醒你。

最后一步，就是和你確認當前所在目錄，是否可以信任。

這里選擇是，然后回車。

我們就終于來到接入GLM-5.1的Claude Code的對話界面了。

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

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

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

這里推薦大家用下面這行命令，特別是開發的時候，不然點各種allow會點到你懷疑人生。

claude --dangerously-skip-permissions

然后我們啟動的時候，因為上下文設計，為了讓他有約束，更加的專注，所以我們是需要對著一個文件夾進行啟動的，而不是直接在根目錄啟動Claude Code。

我自己就分了一下目錄，文稿是我拿來做知識創作了。

還有一個code文件夾，下面都是我自己開發的各種各樣的產品。

在命令行中對著一個命令行啟動Claude Code也特別簡單。

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

比如我要進入知識庫這個文件夾進行創作。

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

按下回車，就算是進入這個文件夾了。

然后這個時候再用命令啟動Claude Code就可以。

你就會進入到這個文件夾下，它默認就只在這個文件夾下工作，默認讀取你這個文件夾下的所有文件。

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

四. 寫CLAUDE.md

學會啟動之后，其實你就可以正式的對話了，隨便讓他干活就行。

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

而在我看來，這甚至是學會啟動Claude Code之后，第一件該做的事。

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

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

就像我之前用過的這張圖。

剛裝完，我們應該去管的兩層，就是全局CLAUDE.md和項目CLAUDE.md。

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

只要你打開Claude Code，不管你進的是哪個項目，它都會被自動加載和遵守。

這是他的頂層規范。

它可以解決的是你是誰、你做事的原則、你希望他用什么方式跟你協作這一層的問題。

而項目級CLAUDE.md，放在每個項目的根目錄下，路徑就是項目目錄/CLAUDE.md。

它只在你打開這個項目的時候才會被加載。

它解決的是這個具體的項目要怎么干，有什么特殊約定這一層的問題。

我們先來聊全局CLAUDE.md，也是第一個需要定好的東西，但是到底該往CLAUDE.md里寫什么、怎么寫、寫多長、放哪里，很多人其實不清楚，對于非開發者來說，我也分享一下我的經驗。

關于長度，CLAUDE.md不是越長越好，反而是要盡量精簡。

你的CLAUDE.md寫得太長，后半段的內容它會直接忽略掉。

具體的紅線數字是這樣的，超過80行，Claude開始遺漏部分內容，最多最多，一定不要超過200行。

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

在我的內容的基礎上，我又迭代了一下，為大家準備了一份模板。

里面都是一些我覺得一份不錯的全局CLAUDE.md應該有的東西。

大家只需要在關于我里面，寫上自己的內容，其他基本都是可以直接復用的。

- 大改動前先在 Plan Mode 出方案，我確認后再動手

一共30多行，分成六個部分。

這六個塊都有一個共同特征，就是跨項目通用。

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

那至于下一層，項目CLAUDE.md。

拿我自己舉例。

我主要用Claude Code來做開發和知識管理。

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

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

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

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

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

這也是我一直強調約束先行、規范先行的原因之一。

約束定好了，那就真的可以開始玩起來了。

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

我這里就不展開了，我也寫過了很多相關的文章，感興趣的小伙伴可以直接去對應著搜索關鍵詞就行。

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

Claude Code，就是我推薦你的當前AI版本的畢業工具。

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

希望大家都能愉快創造。

做出這個時代。

屬于你自己的作品。

以上，既然看到這里了，如果覺得不錯，隨手點個贊、在看、轉發三連吧，如果想第一時間收到推送，也可以給我個星標?～謝謝你看我的文章，我們，下次再見。

>/ 作者：卡茲克，tashi

>/ 投稿或爆料，請聯系郵箱：wzglyay@virxact.com