本文最后更新于：2026年3月19日 下午

Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具，能够在终端中直接辅助代码编写、调试、重构等开发任务。本文详细介绍其安装配置、基本使用、MCP 扩展和进阶技巧。

简介

Claude Code 是 Anthropic 推出的官方 CLI 工具，将 Claude 的能力直接带到终端环境中。与传统代码补全工具不同，Claude Code 能够理解整个项目上下文，执行复杂的编程任务。

核心能力：

功能 说明
代码编写与修改 创建、编辑、重构代码文件
代码审查 分析代码质量，提出改进建议
Bug 调试与修复 定位问题，生成修复方案
文档生成 自动生成 README、API 文档等
项目架构分析 理解项目结构，生成架构图
命令行操作执行 在沙箱环境中执行 shell 命令
Git 工作流 智能提交、代码审查、分支管理
数据库操作 设计表结构、生成迁移、查询优化

快速开始（5分钟上手）

最快安装方式

1
2
3
4
5
6
7
8
9
10
11
# 1. 确保已安装 Node.js（v18+）
node --version

# 2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 3. 验证安装
claude --version

# 4. 启动并认证
claude

立即体验

1
2
3
4
5
6
7
8
# 快速执行任务
claude -p "创建一个 Python 快速排序函数"

# 跳过权限确认（提高效率）
claude --dangerously-skip-permissions

# 继续上次对话
claude --continue

详细安装指南

系统要求

组件 最低版本 推荐版本 说明
Node.js v18.0.0 v20.x LTS 必需，运行环境
npm v8.0.0 v10.x 包管理器
Git v2.0.0 v2.40+ 版本控制（可选）
操作系统 - - Windows 10+/macOS 12+/Linux

Windows 安装（WSL 方案）

Claude Code 基于 Unix 哲学设计，需要 POSIX 兼容环境。WSL 提供了最佳的 Windows 兼容性。

步骤1：安装 WSL

1
2
3
4
5
6
7
8
# 在 PowerShell（管理员模式）中运行
wsl --install

# 查看可用发行版
wsl --list --online

# 安装特定发行版（推荐 Ubuntu）
wsl --install -d Ubuntu

步骤2：配置 WSL 环境

1
2
3
4
5
# 重启后，在 WSL 终端中更新系统
sudo apt update && sudo apt upgrade -y

# 安装必要工具
sudo apt install -y curl wget git build-essential

步骤3：安装 Node.js

1
2
3
4
5
6
7
# 使用 NodeSource 仓库（推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

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

步骤4：安装 Claude Code

1
2
3
4
5
# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

macOS 安装

方法1：使用 Homebrew（推荐）

1
2
3
4
5
6
7
8
# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node@20

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

方法2：直接安装

访问 https://nodejs.org 下载 macOS 安装包，然后：

1
npm install -g @anthropic-ai/claude-code

Linux 安装

Ubuntu/Debian 系统

1
2
3
4
5
6
7
8
9
# 更新包列表
sudo apt update

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

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

CentOS/RHEL/Fedora 系统

1
2
3
4
5
6
# 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install nodejs

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

Arch Linux

1
2
3
4
5
# 安装 Node.js
sudo pacman -S nodejs npm

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

安装验证

1
2
3
4
5
6
7
8
9
# 检查版本
claude --version
# 输出：Claude Code v1.0.0

# 检查帮助
claude --help

# 测试基本功能
claude -p "echo 'Hello Claude Code'"

配置与认证

首次认证

自动认证流程

1
2
3
4
5
6
7
# 启动 Claude Code
claude

# 系统提示：
# Welcome to Claude Code!
# To get started, you need to authenticate with your Anthropic account.
# Press Enter to open your browser and complete authentication...

手动认证（如果自动认证失败）

1
2
3
4
5
# 手动初始化
claude init

# 如果浏览器无法自动打开
claude auth login --manual

认证成功标志

1
2
✓ Authentication successful!
✓ Claude Code is ready to use.

环境变量配置

基础配置

1
2
3
4
5
6
7
8
# 设置 API 密钥（如果需要）
export ANTHROPIC_API_KEY=your_api_key

# 设置自定义模型
export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022

# 设置基础 URL（用于代理）
export ANTHROPIC_BASE_URL=https://your-proxy.com/v1

持久化配置

1
2
3
4
5
6
# 添加到 shell 配置文件
echo 'export ANTHROPIC_API_KEY=your_api_key' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022' >> ~/.bashrc

# 重新加载配置
source ~/.bashrc

代理配置

HTTP 代理

1
2
3
4
5
6
7
# 设置代理
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# 设置 npm 代理
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

国内用户优化

1
2
3
4
5
# 使用淘宝 npm 镜像
npm config set registry https://registry.npmmirror.com

# 临时使用镜像安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

基础命令详解

启动命令

命令 功能 示例
claude 启动交互模式 claude
claude -p "任务" 快速执行单个任务 claude -p "创建一个 React 组件"
claude --continue 继续上次对话 claude -c
claude --resume 选择历史对话 claude -r
claude --help 显示帮助信息 claude -h
claude --version 显示版本信息 claude -v

高级启动选项

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 跳过权限确认（危险但高效）
claude --dangerously-skip-permissions

# 指定配置文件
claude --config /path/to/config.json

# 调试模式
claude --debug

# 静默模式
claude --quiet

# 指定工作目录
claude --cwd /path/to/project

会话内命令（斜杠命令）

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

快捷键

快捷键 功能 说明
ESC 中断当前操作 停止 AI 执行
Ctrl+Z 退出 Claude 模式 返回普通终端
Ctrl+V 粘贴图片 直接粘贴截图分析
Ctrl+C 强制退出 强制终止程序
Tab 自动补全 补全命令和路径

Think 模式完全指南

Think 模式是 Claude Code 的核心特色，能激活 AI 的深度思考能力。

Think 模式对比

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

使用示例

基础思考

1
用户：think 这个函数有什么问题？

深度思考

1
用户：think hard 设计一个高并发的用户认证系统

极深度思考

1
用户：ultrathink 分析这个分布式系统的性能瓶颈并提出优化方案

Think 模式最佳实践

  1. 根据问题复杂度选择：简单问题用 think，复杂问题用 ultrathink
  2. 成本考虑：Max 套餐用户可以多用 ultrathink，免费用户谨慎使用
  3. 时间权衡：紧急任务用基础模式，深度分析用高级模式

MCP 服务器配置详解

MCP 基础概念

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

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

MCP 服务器作用域

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

添加 MCP 服务器

方法1：命令行添加（推荐新手）

1
2
3
4
5
6
7
8
# 基本语法
claude mcp add <名称> [选项] -- <命令> [参数...]

# 添加文件系统访问
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects

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

方法2：编辑配置文件（推荐高级用户）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
      "env": {}
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

10个必备 MCP 服务器

1. 文件系统访问（必装）

1
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects ~/Desktop

用途：让 Claude 直接读写文件，修改代码

2. GitHub 集成

1
claude mcp add github -s user -e GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

用途：管理 issues、PRs、代码审查

3. 网页浏览器控制

1
claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

用途：自动化网页操作、爬虫、测试

4. 数据库连接（PostgreSQL）

1
claude mcp add postgres -s user -e DATABASE_URL=postgresql://user:pass@localhost/db -- npx -y @modelcontextprotocol/server-postgres

用途：直接查询和操作数据库

5. API 调用工具

1
claude mcp add fetch -s user -- npx -y @kazuph/mcp-fetch

用途：调用各种 REST API

6. 搜索引擎

1
claude mcp add search -s user -e BRAVE_API_KEY=your_key -- npx -y @modelcontextprotocol/server-brave-search

用途：搜索最新信息

7. Slack 集成

1
claude mcp add slack -s user -e SLACK_TOKEN=your_token -- npx -y @modelcontextprotocol/server-slack

用途：发送消息、管理频道

8. 时间管理

1
claude mcp add time -s user -- npx -y @modelcontextprotocol/server-time

用途：时区转换、日期计算

9. 内存存储

1
claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory

用途：跨对话保存信息

10. Sequential Thinking（思维链）

1
claude mcp add thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking

用途：复杂问题分步骤思考

MCP 管理命令

1
2
3
4
5
6
7
8
9
10
11
# 查看已安装的 MCP 服务器
claude mcp list

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

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

# 查看 MCP 状态
/mcp

MCP 故障排除

常见错误1：工具名称验证失败

1
API Error 400: "tools.11.custom.name: String should match pattern '^[a-zA-Z0-9_-]{1,64}'"

解决方案：

  • 确保服务器名称只包含字母、数字、下划线和连字符
  • 名称长度不超过 64 个字符

常见错误2：找不到 MCP 服务器

1
MCP server 'my-server' not found

解决方案：

  1. 检查作用域设置是否正确
  2. 运行 claude mcp list 确认服务器已添加
  3. 重启 Claude Code

常见错误3：Windows 路径问题

1
Error: Cannot find module 'C:UsersusernameDocuments'

解决方案：使用正斜杠或双反斜杠

1
2
# 正确方式
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem C:/Users/username/Documents

调试技巧

1
2
3
4
5
6
7
8
9
# 启用调试模式
claude --mcp-debug

# 查看日志文件
tail -f ~/Library/Logs/Claude/mcp*.log  # macOS
type "%APPDATA%\Claude\logs\mcp*.log"   # Windows

# 手动测试服务器
npx -y @modelcontextprotocol/server-filesystem ~/Documents

记忆系统详解

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

记忆文件类型

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

用户记忆文件模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 用户偏好设置

## 编程语言偏好
- 主要语言：Python, JavaScript, TypeScript
- 框架偏好：React, FastAPI, Express

## 代码风格
- 缩进：4个空格
- 变量命名：camelCase（JS）, snake_case（Python）
- 函数命名：动词开头，描述性强
- 注释：中文，详细说明

## 开发环境
- 编辑器：VS Code, Cursor
- 终端：zsh with oh-my-zsh
- 版本控制：Git with conventional commits

## 工作习惯
- 测试驱动开发（TDD）
- 代码审查必须
- 文档先行
- 安全第一

项目记忆文件模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# 项目配置

## 项目信息
- 项目名称：电商平台 API
- 技术栈：Node.js + Express + PostgreSQL + Redis
- 开发环境：Node 20.x, npm 10.x
- 部署环境：Docker + Kubernetes

## 架构说明
- 采用微服务架构
- API 网关：Kong
- 认证：JWT + Redis session
- 数据库：主从分离，读写分离

## 编码规范
- ESLint + Prettier
- 函数命名：camelCase
- 文件命名：kebab-case
- 提交信息：Conventional Commits

## 环境变量
- DATABASE_URL：数据库连接
- REDIS_URL：Redis 连接
- JWT_SECRET：JWT 密钥
- API_PORT：API 端口（默认3000）

## 常用命令
- 启动开发：`npm run dev`
- 运行测试：`npm test`
- 构建项目：`npm run build`
- 数据库迁移：`npm run migrate`
- 代码检查：`npm run lint`

## 注意事项
- 数据库操作必须使用事务
- 异步操作要有错误处理
- 日志记录要详细
- 监控告警要及时

记忆文件管理

1
2
3
4
5
6
7
8
9
10
11
# 编辑用户记忆
/edit

# 编辑项目记忆（在项目目录中）
/edit project

# 查看当前记忆内容
claude "显示我的偏好设置"

# 更新记忆内容
claude "记住我喜欢使用 TypeScript 而不是 JavaScript"

高级使用技巧

1. 项目架构分析

1
2
3
4
5
6
7
8
# 分析整个项目
claude "分析这个项目的架构，给出改进建议"

# 分析特定目录
claude "分析 src/components 目录的组件设计"

# 生成架构图
claude "为这个项目生成 Mermaid 架构图"

2. 代码重构

1
2
3
4
5
6
7
8
# 重构为设计模式
claude "将这个类重构为单例模式"

# 性能优化
claude "优化这个函数的性能，减少时间复杂度"

# 代码清理
claude "清理这个文件中的重复代码"

3. 自动化测试

1
2
3
4
5
6
7
8
# 生成单元测试
claude "为 src/utils/auth.js 生成完整的单元测试"

# 生成集成测试
claude "为用户注册 API 生成集成测试"

# 测试覆盖率分析
claude "分析测试覆盖率，找出未测试的代码"

4. 文档生成

1
2
3
4
5
6
7
8
# 生成 API 文档
claude "为所有 API 端点生成 OpenAPI 3.0 文档"

# 生成 README
claude "为这个项目生成详细的 README.md"

# 生成代码注释
claude "为所有公共函数添加 JSDoc 注释"

5. Git 工作流

1
2
3
4
5
6
7
8
# 智能提交
claude "分析代码变更，生成合适的 commit message"

# 代码审查
claude "审查这个 PR 的代码变更"

# 分支管理
claude "创建 feature 分支并实现用户登录功能"

6. 数据库操作

1
2
3
4
5
6
7
8
# 设计数据库
claude "为电商系统设计数据库表结构"

# 生成迁移文件
claude "生成用户表的数据库迁移文件"

# 查询优化
claude "优化这个 SQL 查询的性能"

7. 部署自动化

1
2
3
4
5
6
7
8
# 生成 Dockerfile
claude "为这个 Node.js 项目生成优化的 Dockerfile"

# Kubernetes 配置
claude "生成 Kubernetes 部署配置文件"

# CI/CD 流水线
claude "创建 GitHub Actions 工作流"

8. 错误调试

1
2
3
4
5
6
7
8
# 日志分析
tail -f app.log | claude -p "分析错误日志，找出问题根源"

# 性能分析
claude "分析这个性能报告，找出瓶颈"

# 内存泄漏检测
claude "检查这个代码是否有内存泄漏"

9. 安全审计

1
2
3
4
5
6
7
8
# 安全扫描
claude "扫描这个项目的安全漏洞"

# 依赖检查
claude "检查 package.json 中的安全漏洞"

# 代码安全
claude "审查这个代码的安全性"

10. 多语言支持

1
2
3
4
5
6
7
8
# 国际化
claude "为这个 React 应用添加 i18n 支持"

# 翻译
claude "将这些英文注释翻译成中文"

# 本地化
claude "为中国用户优化这个应用"

成本控制策略

Token 使用优化

1. 使用 /compact 命令

1
2
3
4
5
# 定期压缩对话
/compact

# 自动压缩（推荐）
claude --auto-compact

2. 限定操作范围

1
2
3
4
5
# 指定具体文件
claude "修复 src/auth.js 中的 bug"

# 而不是
claude "修复认证相关的 bug"

3. 使用 .claudeignore

1
2
3
4
5
# 创建 .claudeignore 文件
echo "node_modules/" >> .claudeignore
echo "dist/" >> .claudeignore
echo "*.log" >> .claudeignore
echo ".env" >> .claudeignore

Think 模式成本控制

套餐类型 推荐策略 说明
免费用户 主要使用 think，谨慎使用高级模式 避免超出限额
Pro 用户 平衡使用，复杂问题用 think hard 性价比最优
Max 用户 可以多用 ultrathink 充分利用额度

成本监控

1
2
3
4
5
6
7
8
# 查看使用统计
claude stats

# 查看当前对话 Token 数
claude token-count

# 设置使用限制
claude set-limit --daily 1000

移动端使用方案

Android 方案（Termux）

安装 Termux

  1. 从 F-Droid 下载 Termux（推荐）
  2. 或从 Google Play 下载

配置环境

1
2
3
4
5
6
7
8
9
10
11
# 更新包列表
pkg update && pkg upgrade

# 安装必要工具
pkg install nodejs git openssh

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

# 配置存储权限
termux-setup-storage

优化配置

1
2
3
4
5
6
7
# 安装 oh-my-zsh
pkg install zsh
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# 配置快捷键
mkdir ~/.termux
echo "extra-keys = [['ESC','/','-','HOME','UP','END','PGUP'],['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']]" > ~/.termux/termux.properties

iOS 方案（SSH）

使用 iSH App

1
2
3
4
5
# 安装 Node.js
apk add nodejs npm

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

使用 SSH 连接

1
2
3
4
5
# 连接到远程服务器
ssh user@your-server.com

# 在服务器上使用 Claude Code
claude

移动端优化技巧

  1. 使用简短命令：移动端输入不便，多用缩写
  2. 语音输入：利用手机语音转文字功能
  3. 云端同步：使用云服务器保持会话连续性
  4. 离线准备：提前下载必要的 MCP 服务器

故障排除指南

安装问题

问题1：command not found: claude

1
2
3
4
5
6
7
8
9
# 检查 PATH
echo $PATH

# 查看 npm 全局路径
npm config get prefix

# 添加到 PATH
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

问题2：权限错误

1
2
3
4
5
# 设置 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile

问题3：网络连接问题

1
2
3
4
5
6
7
8
9
# 检查网络
ping anthropic.com

# 设置代理
export HTTP_PROXY=http://proxy:port
export HTTPS_PROXY=http://proxy:port

# 使用镜像源
npm config set registry https://registry.npmmirror.com

认证问题

问题1：认证失败

1
2
3
4
5
6
7
8
# 清除认证信息
claude logout

# 重新认证
claude init

# 手动认证
claude auth login --manual

问题2：API 密钥问题

1
2
3
4
5
# 检查环境变量
echo $ANTHROPIC_API_KEY

# 重新设置
export ANTHROPIC_API_KEY=your_new_key

性能问题

问题1：响应慢

1
2
3
4
5
6
7
8
# 清理缓存
claude cache clear

# 压缩对话
/compact

# 限定范围
claude "只分析 src 目录"

问题2：内存占用高

1
2
3
4
5
# 重启 Claude Code
claude restart

# 清理日志
claude logs clear

MCP 问题

问题1：MCP 服务器无法启动

1
2
3
4
5
6
7
8
9
# 检查服务器状态
claude mcp test <server_name>

# 查看错误日志
claude mcp logs <server_name>

# 重新安装服务器
claude mcp remove <server_name>
claude mcp add <server_name> ...

问题2：工具不可用

1
2
3
4
5
6
7
8
# 检查 MCP 列表
claude mcp list

# 重启 MCP 服务
claude mcp restart

# 检查权限
ls -la ~/.claude.json

完整命令参考

基础命令

命令 简写 功能 示例
claude - 启动交互模式 claude
claude --help claude -h 显示帮助 claude -h
claude --version claude -v 显示版本 claude -v
claude --prompt claude -p 快速执行 claude -p "创建函数"
claude --continue claude -c 继续对话 claude -c
claude --resume claude -r 恢复对话 claude -r

高级选项

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 跳过权限确认
claude --dangerously-skip-permissions

# 指定配置文件
claude --config /path/to/config.json

# 调试模式
claude --debug

# 静默模式
claude --quiet

# 指定工作目录
claude --cwd /path/to/project

# 自动压缩
claude --auto-compact

# MCP 调试
claude --mcp-debug

MCP 管理命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 添加 MCP 服务器
claude mcp add <name> [options] -- <command> [args...]

# 删除 MCP 服务器
claude mcp remove <name>

# 列出 MCP 服务器
claude mcp list

# 测试 MCP 服务器
claude mcp test <name>

# 查看 MCP 日志
claude mcp logs <name>

# 重启 MCP 服务
claude mcp restart [name]

认证命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 初始化认证
claude init

# 登录
claude auth login

# 登出
claude auth logout

# 查看认证状态
claude auth status

# 刷新 token
claude auth refresh

配置命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查看配置
claude config show

# 设置配置
claude config set <key> <value>

# 重置配置
claude config reset

# 导出配置
claude config export > config.json

# 导入配置
claude config import config.json

缓存管理

1
2
3
4
5
6
7
8
# 清理缓存
claude cache clear

# 查看缓存大小
claude cache size

# 缓存统计
claude cache stats

日志管理

1
2
3
4
5
6
7
8
# 查看日志
claude logs show

# 清理日志
claude logs clear

# 日志级别
claude logs level debug|info|warn|error

生态工具与资源

官方资源

第三方工具

工具 功能 项目地址
Claude Code Router 多模型路由，成本优化 github.com/LLM-Red-Team/kimi-cc
Kimi K2 集成 集成 Kimi 和 Groq 模型 github.com/fakerybakery/claude-code-kimi-groq
VS Code 扩展 在 VS Code 中使用 Claude Code VS Code 扩展市场搜索
Cursor 集成 在 Cursor 中使用 Claude Code Terminal 集成

MCP 服务器生态

官方服务器

  • @modelcontextprotocol/server-filesystem
  • @modelcontextprotocol/server-github
  • @modelcontextprotocol/server-postgres
  • @modelcontextprotocol/server-brave-search

社区服务器

  • @kazuph/mcp-fetch
  • @modelcontextprotocol/server-puppeteer
  • @modelcontextprotocol/server-slack
  • @modelcontextprotocol/server-memory

中文资源

总结与建议

快速上手清单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 2. 完成认证
claude init

# 3. 添加基础 MCP 服务器
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents

# 4. 配置记忆文件
/edit

# 5. 体验 Think 模式
think 创建一个 React 组件

最佳实践总结

效率优化

  • 使用 --dangerously-skip-permissions 跳过权限确认
  • 定期使用 /compact 压缩对话
  • 配置详细的记忆文件
  • 合理使用 Think 模式

成本控制

  • 限定操作范围
  • 使用 .claudeignore 排除无关文件
  • 选择合适的 Think 模式
  • 考虑 API 中转服务

安全建议

  • 保护 API 密钥
  • 谨慎使用权限跳过
  • 定期备份配置
  • 只安装可信的 MCP 服务器

团队协作

  • 使用项目级 MCP 配置
  • 统一编码规范
  • 共享记忆文件模板
  • 建立使用规范

参考资料



文章链接：
https://www.zywvvd.com/notes/study/llm/claude-code/claude-code/

“觉得不错的话，给点打赏吧 ୧(๑•̀⌄•́๑)૭”

微信二维码

微信支付

支付宝二维码

支付宝支付

Large_Language_Model > Claude
#Large_Language_Model #Claude #AI #CLI
Claude Code 使用指南
https://www.zywvvd.com/notes/study/llm/claude-code/claude-code/
作者
Yiwei Zhang
发布于
2026年3月19日
许可协议