--- title: "1.0 Quick Start" description: "Set up your environment and start AI coding in 5 minutes" chapter: "Chapter 1" --- # 1.0 Quick Start > **After reading this section, you will be able to:** > > - Install Git, Node.js, and Claude Code > - Configure the pnpm package manager and a China mirror to speed up downloads > - Set up the GLM model and start AI coding This section provides the simplest and most straightforward setup process so you can start AI coding quickly. > **Windows user?** Start reading below. > **Mac/Linux user?** [Click here to jump to the installation guide](#mac-linux-users) --- ## Windows Users {#windows-users} ### 1. Install [Git](https://git-scm.com/install/windows) **Download**: ![image-20260203180304836](/images/Advanced/image-20260203180304836.png) After downloading, double-click to install, and **just keep clicking "Next"** (skip if already installed). ### 2. Install [Node.js](https://nodejs.org/zh-cn/download)![image-20260203180429883](/images/Advanced/image-20260203180429883.png) **Download**: After downloading, double-click to install, and **just keep clicking "Next"** (skip if already installed). ### 3. Verify the Installation Press `Win + X`, then choose **Terminal (Admin)** or **Windows PowerShell**, and run: ```powershell git --version node -v ``` If version numbers are displayed, the installation was successful. ![image-20260203180527608](/images/Advanced/image-20260203180527608.png) If you see a "command not recognized" message, close the terminal and open it again. If that still doesn't work, restart your computer. ### 4. Configure a China Mirror and Install pnpm Run the following in PowerShell: ```powershell npm config set registry https://registry.npmmirror.com/; npm install -g pnpm; pnpm setup; pnpm config set registry https://registry.npmmirror.com/ ``` ![image-20260203180609407](/images/Advanced/image-20260203180609407.png) ::: warning PowerShell execution policy error? If you get the error "cannot load script because running scripts is disabled on this system" when running commands in PowerShell, start PowerShell as an administrator, then run: ```powershell Set-ExecutionPolicy RemoteSigned -Scope CurrentUser ``` Then rerun the command above. ![image-20260203180635579](/images/Advanced/image-20260203180635579.png) ::: ### 5. Install Claude Code Run the following in PowerShell: ```powershell npm install -g @anthropic-ai/claude-code ``` After the installation finishes, run: ```powershell claude ``` If you see the Claude Code welcome screen, the installation was successful! ![image-20260203180714506](/images/Advanced/image-20260203180714506.png) ::: warning If you see "No suitable shell found" This means Git was not installed correctly. Please set the environment variable: 1. Press `Win + S` and search for "environment variables" ![image-20260203180856348](/images/Advanced/image-20260203180856348.png) 2. Click "Edit the system environment variables" 3. Click "Environment Variables" ![image-20260203180925214](/images/Advanced/image-20260203180925214.png) 4. Under "System variables", click "New" 5. Variable name: `CLAUDE_CODE_GIT_BASH_PATH` 6. Variable value: `C:\Program Files\Git\bin\bash.exe` ![image-20260203181030343](/images/Advanced/image-20260203181030343.png) 7. Click OK to save, then **restart PowerShell** and try again If it still doesn't work, uninstall Git and reinstall it. ::: --- ## Mac/Linux Users {#mac-linux-users} ### 1. Install Git **macOS**: - The first time you type `git` in Terminal, you'll be prompted to install the Xcode Command Line Tools. Just click Install. - Or run it manually: `xcode-select --install` - If you want the latest version, use Homebrew: `brew install git` **Linux**: ```bash # Ubuntu/Debian sudo apt update && sudo apt install git -y # CentOS/RHEL sudo yum install git -y ``` ### 2. Open Terminal - **Mac**: Press `Cmd + Space`, then type "Terminal" - **Linux**: Press `Ctrl + Alt + T` ### 3. Run the Environment Initialization Script This script will automatically install Node.js, pnpm, and configure a China mirror: **macOS:** ```bash curl -fsSL https://cnb.cool/vibevibe/scripts/-/git/raw/main/init-node-mac.sh | sed 's/\r$//' | sh && npm install -g pnpm && pnpm config set registry https://registry.npmmirror.com/ && pnpm setup ``` **Linux:** ```bash curl -fsSL https://cnb.cool/vibevibe/scripts/-/git/raw/main/init-node-linux.sh | sed 's/\r$//' | sh ``` After the script finishes, **please reopen the terminal window** (or run `source ~/.bashrc` / `source ~/.zshrc`) to apply the configuration. This script automatically sets up the following: **nvm** (Node Version Manager, used to switch between Node.js versions), **Node.js** (the JavaScript runtime used to execute TypeScript code), **pnpm** (a package manager that is faster and more space-efficient than npm), and **a China mirror** (configures the Taobao mirror to speed up dependency downloads). ### 3. Verify the Installation ```bash git --version node -v ``` If version numbers are displayed, the installation was successful. ### 4. Install Claude Code ```bash npm install -g @anthropic-ai/claude-code ``` After the installation finishes, run: ```bash claude ``` If you see the Claude Code welcome screen, the installation was successful! --- ## Configure the GLM Model {#config-glm} Claude Code uses Anthropic's official Claude models by default, but you can also configure a domestic model such as GLM, which is more affordable and faster to access. **Step 1: Get an API Key** Visit the [Zhipu Open Platform](https://open.bigmodel.cn/), click the "Sign Up / Log In" button in the upper-right corner, and follow the prompts to complete account registration. After logging in, go to your personal center page, click [API Keys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys), and create a new API Key. ![image-20260203181347764](/images/Advanced/image-20260203181347764.png) ![image-20260203181406471](/images/Advanced/image-20260203181406471.png) **Step 2: One-click helper install - automatic configuration** Run the following in Terminal/PowerShell: ```bash npx @z_ai/coding-helper ``` ![Description](/images/Advanced/1764741445765coding-tool-helper.gifattname=coding-tool-helper.gif) Enter the API Key you obtained, and the tool will automatically complete all configuration steps. **Step 3: Verify the Configuration** ```bash claude ``` Claude Code will now use the GLM model to answer your questions. ::: tip Official documentation For more configuration details, see [GLM Official Documentation - Claude Code Configuration Guide](https://docs.bigmodel.cn/cn/coding-plan/tool/claude). ::: ::: tip Need to manage multiple model providers? If you need to frequently switch between different AI model providers (such as GLM, DeepSeek, OpenAI, etc.), you can use [cc-switch](https://github.com/farion1231/cc-switch) — a desktop GUI configuration management tool that supports Claude Code, Codex, and Gemini CLI. It lets you switch API configurations with one click, centrally manage MCP servers and Skills, and supports speed testing and quick switching from the system tray. ![Main interface](/images/Advanced/main-zh.png) ::: --- ## About nvm (Optional) {#about-nvm} The initialization script for Mac/Linux users automatically installs nvm (Node Version Manager). If Windows users want to manage multiple Node.js versions, you can install nvm: ![image-20260203181915052](/images/Advanced/image-20260203181915052.png) **Download** link: Or: **Set the mirror after installation**: ```powershell nvm node_mirror https://npmmirror.com/mirrors/node/ nvm npm_mirror https://npmmirror.com/mirrors/npm/ ``` **Common commands**: ```bash nvm install 24.13.0 # Install a specific version nvm use 24.13.0 # Use a specific version nvm list # View installed versions ``` ::: details 🔄 Click to try it: Node Version Manager Try switching between different Node.js versions: > 💡 **Practice**: Click different versions to switch and observe how the current version changes. > > 🎯 **Core concept**: nvm lets you manage multiple Node.js versions on the same computer. ::: --- ## FAQ {#faq} ### Q: Ran into an error during installation? Copy the error message and give it to an AI assistant. It will help you solve it. ### Q: Do I have to use GLM? No. Claude Code uses Anthropic's official Claude models by default, but accessing them from mainland China requires a relay service. GLM is a highly cost-effective alternative, and you can also configure other domestic models such as Minimax, Doubao, and Qwen. ### Q: I already installed Node.js separately. Can I still install nvm? Yes. nvm manages its own separate Node.js versions and won't affect the version you previously installed. After installing nvm, you can use `nvm use` to switch versions or `nvm install` to install new ones. --- ## Next Steps {#next-steps} After finishing the environment setup, continue reading: - [1.1 The Evolution of Code Formats](./01-code-formats.md) - [1.2 Understanding the Tech Stack](./02-tech-stack.md) - [1.5 Package Management and Project Configuration](./05-package-manager-and-config.md) - [1.7 Create Your First Project](./07-creating-project.md)