Claude Code AI 命令行工具安装使用与 MCP 配置指南 | 极客日志

JavaScriptNode.jsAI

Claude Code AI 命令行工具安装使用与 MCP 配置指南

Claude Code 是流行的 AI 命令行工具。内容涵盖多系统安装步骤及 Node.js、Git 依赖配置。通过设置环境变量接入 GLM-4.6 模型 API。包含终端与交互模式常用命令、CLAUDE.md 项目指南编写规范。详解 MCP 协议服务器配置，支持 stdio、SSE、HTTP 传输方式及作用域管理。助力开发者提升编码效率。

DevStack发布于 2026/3/26更新于 2026/4/231 浏览

Claude Code 使用指南

安装与环境

前置依赖

需要 Node.js（会自动安装 npm）和 Git。

安装 Node.js

Windows

访问官网下载 LTS 版本安装包。
双击 .msi 文件，一路点击 Next。
确保勾选 Add to PATH。
推荐勾选其他辅助选项以减少后续错误。

macOS 推荐使用 Homebrew：

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

Linux (Ubuntu)

# 方法一：官方库
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 方法二：apt
sudo apt update
sudo apt install nodejs npm

验证安装

node --version
npm --version

配置镜像与全局路径

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com/

# 设置全局安装路径
npm config set prefix "D:\\nodejs\\npm_global" # Windows
npm config set prefix "~/.npm-global"          # macOS/Linux

# 添加环境变量
# Windows: 在系统变量 PATH 中添加 D:\nodejs\npm_global
# macOS/Linux: 在 ~/.bashrc 或 ~/.zshrc 中添加
export PATH=~/.npm-global/bin:$PATH

# 验证配置
npm config list

安装 Git

Windows 访问官网下载适合系统的安装包并运行。

macOS

brew install git

sudo apt update
sudo apt install git

git --version

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

# 检查安装
claude --version

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','your_zhipu_api_key','User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL','https://open.bigmodel.cn/api/anthropic','User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC','1','User')

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的apikey",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

CLAUDE_GIT_BASH_PATH = Your git-bin path
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = 1

# Windows/Linux
npm uninstall -g claude-code

# Mac
brew uninstall claude-code

# 验证
claude --version

——— # CLAUDE.md
## 你在这个项目里的角色
你是我的结对开发助手。你的工作方式是：先把需求澄清到'可落地'，再把任务拆成可执行的小步骤，然后在每一步都给出可验证的结果（能运行、能测试、能回滚）。你可以提出更优方案，但不要擅自扩大范围。
当你准备修改代码时，先说明'你要改哪些文件 + 为什么'，并等我确认或按权限要求申请。

## 项目概览
项目名称：NoteFlow
一句话目标：做一个可搜索、可标签化的个人知识库笔记系统，支持 Markdown 编辑与预览。
技术栈：Next.js + TypeScript + Tailwind, SQLite/Postgres + Prisma

## 非目标
- 不做多租户企业权限系统
- 不做复杂富文本
- 不做全量协同编辑

## 工作约定
1. 先复述你理解的需求
2. 给一个分步骤计划
3. 默认采用'最小改动'策略
4. 每完成一步就自检
5. 结束时输出：改了什么、怎么验证、有哪些已知限制

## 目录结构
- apps/web: 前端页面与组件
- apps/api: 接口/服务端逻辑
- packages/db: Prisma schema
- docs/: 需求说明、设计决策

## 环境与启动
首次启动：安装依赖 -> 初始化数据库 -> 启动开发服务器 -> 验证首页
常用命令：pnpm i, pnpm dev, pnpm build, pnpm test

## 安全与隐私
- 不要把 token、密码、个人隐私写进文档或提交到仓库
- 需要演示配置时，用占位符（如 YOUR_TOKEN_HERE）

## 输出格式
- 改动摘要
- 影响文件列表
- 验证步骤
- 未解决问题/后续建议
———

# CLAUDE.md - 站点指南
此文件为 Claude Code 在此代码仓库中工作时提供指导。

## 1. 仓库概览
此代码仓库包含一个使用 Jekyll 和 Minimal Mistakes 主题构建的个人博客，托管在 GitHub Pages 上。

## 2. 关键命令
- **本地开发**: `bundle exec jekyll serve`
- **运行测试**: `ci.sh`
- **代码检查**: `npm run lint`

## 3. 代码风格与约定
- **模块语法**: 必须使用 ES 模块 (`import`/`export`) 语法。
- **导入**: 尽可能解构导入。
- **样式**: 所有样式均通过位于 `_sass/` 目录中的 SCSS 文件完成。

## 4. 工作流程
- **测试**: 优先运行单个测试。
- **新博文**: 在 `_posts/` 文件夹中创建，使用 `YYYY-MM-DD-标题.md` 格式。
- **Git 提交**: 遵循约定式提交规范。

## 5. 个人备注
如果遇到困难，请停下来寻求帮助。

# 查看已配置的 MCP servers
claude mcp list

# 查看详细信息
claude mcp get <name>

# 删除某个 server
claude mcp remove <name>

# 基本语法
claude mcp add <name> <command> [args...]

# 示例：注入环境变量
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

# 基本语法
claude mcp add --transport sse <name> <url>

# 示例：携带自定义 header
claude mcp add --transport sse api-server https://api.example.com/mcp --header "X-API-Key: your-key"

# 基本语法
claude mcp add --transport http <name> <url>

# 示例：携带认证 header
claude mcp add --transport http secure-server https://api.example.com/mcp --header "Authorization: Bearer your-token"

# Local (默认)
claude mcp add my-private-server /path/to/server

# Project
claude mcp add shared-server -s project /path/to/server

# User
claude mcp add my-user-server -s user /path/to/server

{"mcpServers":{"shared-server":{"type":"stdio","command":"/path/to/server","args":[]}}}

claude mcp reset-project-choices

{"mcpServers":{"api-server":{"type":"sse","url":"${API_BASE_URL:-https://api.example.com}/mcp","headers":{"Authorization":"Bearer ${API_KEY}"}}}}