全网最全的 Claude Code 上手指南。从安装到进阶，从 MCP 到第三方模型接入，一篇文章讲透。

一、它到底是什么

Claude Code 是 Anthropic 官方出的命令行工具，直接在终端里跟 Claude 交互，帮你写代码、改代码、跑命令。

跟 ChatGPT 那种网页聊天不一样，它是嵌在你开发工作流里的——你在哪个目录下启动它，它就能直接读那个目录的代码，理解项目结构，然后动手改文件。

它把"复制代码到聊天框 → 拿到回复 → 粘贴回编辑器"这个循环给干掉了。

二、安装指南

原生安装器（强烈推荐）

零依赖，不需要 Node.js，装完自动后台更新。

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows
winget install Anthropic.ClaudeCode

Homebrew（macOS）

brew install --cask claude-code

npm（已不推荐）

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

启动

# 进入项目目录
cd your-project

# 启动
claude

# 非交互模式（适合脚本）
claude -p "解释一下 src/auth.ts 里的登录逻辑"

三、核心用法

让它读代码

不确定某段代码干了什么，直接问：

这个项目的入口文件在哪？整体架构是怎样的？

让它改代码

把 src/auth.ts 里的密码验证改成 bcrypt

让它跑命令

帮我跑一下 npm test，看看测试过没过

让它管 Git

帮我提交这次改动，commit message 写"添加用户认证模块"

四、权限模型

Claude Code 有三级权限控制：

模式	说明	适用场景
Ask	执行前询问	高风险操作
Auto-edit	自动执行低风险操作	开发环境
Full auto	完全自主执行	自动化脚本

五、CLAUDE.md 配置

项目根目录创建 CLAUDE.md，Claude Code 启动时自动读取：

## 角色
你是一个 React 专家，负责[项目描述]

## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 规范
- 使用 TypeScript strict 模式
- 组件放在 src/components/
- 样式使用 Tailwind CSS

## 禁止
- 不要直接操作生产数据库
- 不要提交代码前跳过 lint

六、MCP 配置

MCP（Model Context Protocol）让 Claude Code 能连接外部工具。

7个推荐 MCP Server

MCP Server	功能	安装
filesystem	文件读写	npx -y @modelcontextprotocol/server-filesystem ./
brave-search	网页搜索	npx -y @modelcontextprotocol/server-brave-search
github	GitHub 操作	npx -y @modelcontextprotocol/server-github
sqlite	SQLite 数据库	npx -y @modelcontextprotocol/server-sqlite
sequential-thinking	复杂任务推理	npx -y @anthropic/mcp-server-sequential-thinking
puppeteer	浏览器自动化	npx -y @modelcontextprotocol/server-puppeteer
slack	Slack 消息	npx -y @modelcontextprotocol/server-slack

配置示例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your-token"
      }
    }
  }
}

七、Skills 创建

Skills 是 Claude Code 的可复用任务模板。

Frontmatter 字段

---
name: code-review
description: 对代码进行审查
author: Your Name
tags: [development, quality]
args:
  - name: path
    description: 要审查的代码路径
    required: true
---

八、内置 Slash Commands

命令	功能
/help	查看帮助
/clear	清空对话
/patch	查看补丁
/exit	退出
/compact	压缩上下文
/model	切换模型
/claude-code	Claude Code 帮助
/browse	浏览网页
/read	读取文件
/edit	编辑文件
/write	写入文件

九、实际工作流场景

场景1：快速代码审查

/read src/auth.ts
帮我审查这段代码的问题

场景2：自动化测试

帮我写测试用例覆盖 login 函数

场景3：Git 操作

/commit "添加用户认证"

场景4：MCP 工具调用

用 github MCP 创建一个新分支 feature/user-auth

场景5：复杂重构

帮我把这段类组件改成函数组件，使用 Hooks

十、实用技巧

1. 非交互模式

# 单次任务
claude -p "解释这个函数" src/utils.js

# 管道输入
cat error.log | claude -p "分析这个错误"

2. 环境变量

export ANTHROPIC_API_KEY=sk-ant-xxx
claude

3. 代理配置

export HTTPS_PROXY=http://127.0.0.1:7890
claude

十一、不擅长什么

场景	原因
超大代码库	上下文窗口限制
实时数据	知识截止日期
复杂图形界面	命令行工具限制
Windows GUI 操作	主要面向开发者

十二、接入第三方模型

DeepSeek

# ~/.claude/settings.local.json
{
  "models": [
    {
      "name": "deepseek",
      "model": "deepseek-chat",
      "apiKey": "your-deepseek-key",
      "apiBase": "https://api.deepseek.com"
    }
  ]
}

OpenRouter

{
  "models": [
    {
      "name": "openrouter",
      "model": "anthropic/claude-3.5-sonnet",
      "apiKey": "your-openrouter-key"
    }
  ]
}

Ollama（本地）

{
  "models": [
    {
      "name": "ollama",
      "model": "llama3",
      "apiBase": "http://localhost:11434"
    }
  ]
}

费用相关

模型	输入	输出	说明
Claude 3.5 Sonnet	$3/1M	$15/1M	推荐
Claude 3 Opus	$15/1M	$75/1M	高端
Claude 3 Haiku	$0.25/1M	$1.25/1M	便宜

一句话总结

Claude Code = 嵌在终端里的 AI 编程助手，把"复制粘贴"循环干掉了。

核心能力：

• 读代码 / 改代码 / 跑命令 / 管 Git
• MCP 扩展外部工具
• Skills 复用任务模板
• 第三方模型接入

安装一行命令：

curl -fsSL https://claude.ai/install.sh | bash