🚀 Claude Code 开发环境搭建指南

1

安装 Node.js

Windows 安装

# 方法 1: 使用 winget (推荐)
winget install OpenJS.NodeJS.LTS

# 方法 2: 官网下载安装包
# 访问 https://nodejs.org/en/download
# 下载 Windows installer (.msi) 并运行

macOS 安装

# 使用 Homebrew (推荐)
brew install node

# 验证安装
node -v
npm -v

Linux (Ubuntu) 安装

# 使用 NVM (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重启终端或执行
source ~/.bashrc

# 安装 LTS 版本
nvm install --lts
nvm use --lts

2

安装 Git

Windows

winget install Git.Git

macOS

brew install git

Ubuntu

sudo apt update
sudo apt install git -y

3

安装 Claude Code CLI

# 全局安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

步骤 1: 获取智谱 AI API Key

1. 访问智谱 AI 开放平台：https://open.bigmodel.cn/
2. 注册并完成实名认证
3. 进入控制台创建 API Key
4. 复制 API Key 备用

步骤 2: 配置环境变量

macOS / Linux

# 临时配置（当前终端会话有效）
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的智谱 API 密钥"
export ANTHROPIC_MODEL="glm-5"

# 永久配置（写入配置文件）
echo 'export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的智谱 API 密钥"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="glm-5"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

# 临时配置
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的智谱 API 密钥"
$env:ANTHROPIC_MODEL="glm-5"

# 永久配置（用户级别）
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.z.ai/api/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '你的智谱 API 密钥', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'glm-5', 'User')

# 获取阿里云百炼 API Key
# 访问：https://www.aliyun.com/product/bailian

export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export ANTHROPIC_AUTH_TOKEN="你的阿里云 API 密钥"
export ANTHROPIC_MODEL="qwen-coder-plus"

安装扩展

1. 打开 VS Code
2. 进入扩展市场 (Ctrl+Shift+X)
3. 搜索 "Claude Code" 或 "Cline"
4. 安装扩展

配置扩展

在 VS Code 设置中添加:

{
  "claudeCode.apiKey": "你的 API 密钥",
  "claudeCode.baseUrl": "https://api.z.ai/api/anthropic",
  "claudeCode.model": "glm-5"
}

安装插件

1. 打开 IDEA
2. File → Settings → Plugins
3. 搜索 "Claude Code" 或 "Lingma"
4. 安装并重启 IDEA

配置插件

1. Settings → Tools → Claude Code
2. 输入 API Key 和 Base URL
3. 测试连接

# 进入项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

# 或直接执行命令
claude "帮我创建一个 Python Flask 应用"

配置 MCP Server

创建 ~/.claude/mcp.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

创建 ~/.claude/hooks.json

{
  "hooks": {
    "beforeCommand": {
      "script": "echo 'Executing command...'",
      "enabled": true
    },
    "afterFileChange": {
      "script": "npm run lint",
      "enabled": true
    },
    "onError": {
      "script": "echo 'Error occurred, logging...'",
      "enabled": true
    }
  }
}

{
  "version": "1.0",
  "projectName": "my-project",
  "model": "glm-5",
  "maxTokens": 8192,
  "temperature": 0.7,
  "systemPrompt": "你是一个专业的全栈开发工程师，擅长 Python 和 TypeScript 开发。",
  "allowedTools": ["bash", "write", "read", "edit"],
  "ignoredFiles": [
    "node_modules/**",
    ".git/**",
    "*.log",
    "dist/**"
  ]
}