Claude Code 完全入门教程:从安装到高效使用,一篇就够了

Viewed 4

Claude Code 是什么?

Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具(CLI)。它直接运行在你的终端中,能够理解你的整个项目代码库,帮你写代码、修 Bug、重构、搜索文件——几乎所有编程任务它都能搞定。

简单理解:它就像一个住在你终端里的高级程序员搭档。

Claude Code 官方界面


安装前的准备

在安装 Claude Code 之前,你需要确保以下条件已满足:

1. 安装 Node.js(必须)

Claude Code 基于 Node.js 运行,你需要 Node.js 18 或更高版本

Windows 安装方法:

前往 Node.js 官网 下载 LTS 版本,双击安装即可。

或者用包管理器安装:

# 使用 winget(Windows 自带)
winget install OpenJS.NodeJS.LTS

# 使用 Chocolatey
choco install nodejs-lts

macOS 安装方法:

# 使用 Homebrew
brew install node

Linux 安装方法:

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

安装完成后验证:

node --version   # 应该显示 v18.x.x 或更高
npm --version    # 应该显示 9.x.x 或更高

2. 拥有 Anthropic 账号

你需要以下任一订阅:

  • Claude Pro / Max 订阅(推荐个人用户)
  • Anthropic API Key(适合开发者)

安装 Claude Code

满足前提条件后,一行命令即可安装:

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

安装完成后,在终端输入:

claude

首次运行会引导你完成登录认证。

其他安装方式:

# macOS Homebrew
brew install claude-code

# Windows WinGet
winget install Anthropic.ClaudeCode

5 分钟快速上手

安装完成后,进入你的项目目录,启动 Claude Code:

cd my-project
claude

然后直接用自然语言告诉它你想做什么:

> 帮我写一个 Python 函数,计算斐波那契数列的第 N 项
> 这个 Bug 怎么修?报错信息是 TypeError: cannot read property...
> 帮我重构这个文件,把重复代码提取成公共函数

Claude Code 会自动读取你的项目文件、理解上下文,然后给出方案或直接修改代码。

Claude Code 工作界面示意


核心功能详解

1. CLAUDE.md — 项目记忆文件

在项目根目录创建一个 CLAUDE.md 文件,Claude Code 每次启动都会自动读取它。你可以在里面写:

# 项目说明

- 这是一个 React + TypeScript 项目
- 使用 pnpm 作为包管理器
- 测试框架:Vitest
- 代码风格:使用 ESLint + Prettier
- 请所有注释用中文

这样 Claude Code 就能记住你的项目规范,每次对话都会遵循。

2. 常用斜杠命令

在 Claude Code 对话中,你可以使用以下斜杠命令:

命令 说明
/help 查看帮助信息
/init 初始化项目的 CLAUDE.md
/compact 压缩对话历史,释放上下文空间
/clear 清空当前对话
/cost 查看当前会话的 Token 用量和费用
/memory 查看 Claude 的记忆文件
/review 让 Claude 审查代码变更
/commit 智能生成 commit message 并提交
/fast 切换快速模式(同一模型,更快输出)

3. 权限模式

Claude Code 有三种权限模式,控制它能自动执行哪些操作:

模式 说明
默认模式 每次修改文件、运行命令前都会询问你
自动接受编辑 自动接受文件修改,但命令仍需确认
YOLO 模式 全自动,不再询问(谨慎使用)

建议新手使用默认模式,熟悉后再逐步放宽权限。


进阶技巧

1. VS Code 集成

Claude Code 可以直接在 VS Code 中使用:

  1. 安装 VS Code 扩展:在扩展商店搜索 "Claude Code" 并安装
  2. 安装后按 Ctrl+Shift+P(Mac: Cmd+Shift+P)打开命令面板
  3. 输入 "Claude" 即可看到相关命令

你也可以直接在 VS Code 的终端中运行 claude 命令。

2. 使用 Skills(技能系统)

Claude Code 支持自定义技能,放在 ~/.claude/skills/ 目录下。每个技能是一个 Markdown 文件,定义了特定场景下的行为规范:

~/.claude/skills/
  my-workflow/
    SKILL.md    # 技能描述和使用说明

技能可以让 Claude 在特定任务中遵循你定义的流程,比如代码审查规范、部署流程等。

3. MCP 服务器集成

MCP(Model Context Protocol)允许 Claude Code 连接外部工具和数据源:

# 在 Claude Code 中配置 MCP 服务器
# 编辑 ~/.claude/settings.json
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["my-mcp-server"]
    }
  }
}

通过 MCP,你可以让 Claude 访问数据库、调用 API、操作浏览器等。

4. 高效使用技巧

  • 善用 CLAUDE.md:把项目约定写进去,避免每次重复说明
  • 用 /compact 管理上下文:对话太长时压缩历史,保持响应质量
  • 分步提问:复杂任务拆成小步骤,效果更好
  • 用 /review 审查代码:提交前让 Claude 帮你检查
  • 用 /commit 提交:自动生成规范的 commit message

常见问题

Q:Claude Code 免费吗?
A:需要 Claude Pro/Max 订阅或 API Key。Pro 订阅每月有用量限制,API 按 Token 计费。

Q:支持哪些编程语言?
A:几乎所有主流语言都支持——Python、JavaScript/TypeScript、Java、Go、Rust、C++ 等。

Q:我的代码安全吗?
A:Claude Code 在本地运行,代码不会上传到服务器(除非你明确发送对话内容)。详见 Anthropic 的隐私政策。

Q:和 GitHub Copilot 有什么区别?
A:Copilot 主要是代码补全,而 Claude Code 是一个完整的编程助手——能理解整个项目、执行命令、修改文件、搜索代码。它更像一个 AI 结对编程伙伴。


参考资源


本文由 OPC Learn 社区整理发布,欢迎加入我们的社区交流更多 AI 工具使用心得!

0 Answers