ClaudeCode 使用指南

安装

Win环境

1. 安装Node.js

// 使用NodeSource仓库（推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

// 验证安装
node --version
npm --version

2. 安装Git

// 官网下载比较慢，推荐使用镜像下载，我这里用的是清华大学镜像源
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/

3. 安装Claude code

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

// 验证安装
claude --version

// 启动Claude
claude 

4.配置Anthropic服务
当启动claude时，报错

Unable to connect to Anthropic services 
Failed to connect to api.anthropic.com: ERR_BAD _REQUEST

解决方法：

1. 找到.claude.json文件，一般在 c://Users//your_name// 路径下

2. 添加 hasCompletedOnboarding 字段
   在

{
  "installMethod": "unknown",
  "autoUpdates": true,
   ····
  // 可以不管上面的内容
  "hasCompletedOnboarding": true  // 新增字段
}

5.配置GLM api
在 C:\Users\Administrator\.claude路径下修改（新增）setting.json 文件
内容如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": " 你的api密钥 ",
    "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"
  }
}

6.重新启动Claude

// 关闭所有Claude进程（如果有）
pkill -f claude
 
// 重新启动Claude
claude

基础使用

会话内命令（斜杠命令）##

命令	功能	说明
/compact	压缩对话上下文	保留核心信息，节省Token
/clear	清除对话历史	完全重置当前对话
/history	查看历史对话	选择之前的对话继续
/edit	编辑记忆文件	修改用户或项目记忆
/model	切换AI模型	选择不同的Claude模型
/help	显示帮助	查看所有可用命令
/exit	退出Claude Code	返回普通终端

Think模式完全指南

模式	思考深度	Token消耗	适用场景	响应时间
think	基础	低	简单问题、快速回答	2-5秒
think hard	深度	中	复杂逻辑、算法设计	5-15秒
think harder	更深度	高	架构设计、难题分析	15-30秒
ultrathink	极深度	极高	最复杂问题、创新方案	30-60秒

创建自定义命令

Claude Code 支持自定义命令，你可以创建一些命令来快速执行特定的提示或任务。
自定义命令语法：

/<prefix>:<command-name> [arguments]

自定义命令解读：

• 命令分为用户级和项目级；
• 用户级命令所有项目都能用，项目级命令只有当前项目可以用；
• 用户级命令放在个人 ~/.claude/commands目录下，而项目级命令放在当前项目.claude/commands目录下；
• 使用命令时，用户级命令以 /user: 为前缀，项目级命令/project:为前缀，后面跟的是命令文件名称，可级联；
• 命令文件支持使用$ARGUMENTS参数占位符，在命令后面带上参数，如：/project:test 123 它会用 123 替换命令文件中的$ARGUMENTS标记。
  比如如果有 .claude/commands/component.md 自定义命令，使用方法 就是：/project:component。

实战使用

项目级命令

在当前项目创建自定义命令目录：

mkdir -p .claude/commands

创建一个项目级优化命令：

echo "分析这个项目的性能，并提出三个具体的优化建议。" > .claude/commands/optimize.md

在 Claude Code 中使用自定义命令：

/project:optimize

MCP服务器配置详解

MCP基础概念
MCP（Model Context Protocol）是Anthropic推出的开源通信标准，让Claude Code可以：

• 📁 访问本地文件系统
• 🌐 连接各种API服务
• 🗄️ 操作数据库
• 🛠️ 集成开发工具
• 🔧 自动化任务

MCP服务器作用域

作用域	配置位置	适用场景	命令标志
Local	当前目录	项目特定工具	默认
User	~/.claude.json	全局常用工具	-s user
Project	.mcp.json	团队共享工具	-s project

1. 添加MCP服务器

// 基本语法
claude mcp add <名称> [选项] -- <命令> [参数...]

// 添加文件系统访问
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects //后面跟路径
// 如果要追加路径的话需要删除掉之前的再添加
claude mcp remove filesystem -s user
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem  "路径一" "路径二"

// 添加GitHub集成
claude mcp add github -s user -e GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

// 添加Gitee集成

// 添加Sequential Thinking（思维链）
claude mcp add thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking

2. MCP管理命令

// 查看已安装的MCP服务器
claude mcp list

// 删除MCP服务器
claude mcp remove <server_name>

// 测试MCP服务器
claude mcp test <server_name>

// 查看MCP状态
/mcp

记忆系统详解

Claude Code的记忆系统让AI能够记住你的偏好和项目信息。

类型	位置	作用域	用途
用户记忆	~/.claude/CLAUDE.md	全局	个人偏好、编码风格
项目记忆	项目根目录/.CLAUDE.md	项目	项目特定信息

记忆文件管理

/memory
可以在系统编辑器中打开记忆文件

OpenSpec 安装与使用

openSpec是一个比spec-kit更轻量的spec driven开发套件，有了他，你可以一定程度上解决ai coding失控膨胀，以致越来越不可维护的问题。

1. 原理

1. 在项目中创建一个 openspec/ 目录，作为“规格 + 变更记录中心”。
2. 每次需求或改动，都用一个 changes// 文件夹描述：

• 为什么改（proposal.md）
• 要做什么（spec diff）
• 怎么做（tasks.md）

2.安装OpenSpec

npm install -g @fission-ai/openspec@latest
openspec --version   //  确认安装成功

3.初始化项目

cd your-project  // 切换到你项目路径
openspec init

它会询问你使用哪些 AI 工具（Claude Code / Cursor / Factory / Codex / KiloCode 等）

4.OpenSpec使用
OpenSpec 的核心是三个命令：

阶段	命令	目标	输出
规划期	/openspec:proposal	对齐需求与规范	proposal.md + 规范差异（spec diff）
实施期	/openspec:apply	按任务执行开发	更新后的代码 + 完成的任务清单
收尾期	/openspec:archive	合并与归档变更	更新 specs/ 目录 + 归档变更记录