Claude Code 是什么？从安装到上手的完整指南

Claude Code 是什么

Claude Code 是 Anthropic 推出的一款基于终端的 AI 编程助手。与 VS Code 插件不同，它以 CLI 工具的形式运行——这正是它的核心特色。它能够理解你的整个代码库，并在一个地方完成文件编辑、创建新文件、执行命令和 Git 操作。

由于不依赖任何特定编辑器，你可以在任何开发环境中使用它。

安装

前置要求

• 已安装 Node.js 18 或更高版本
• 拥有 Anthropic 账号（Max 计划或 API 访问权限）

通过 npm 安装

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

安装完成后，验证是否安装成功：

claude --version

首次认证

首次启动需要进行身份认证。

claude

运行该命令后会打开浏览器，引导你登录 Anthropic 账号进行认证。认证完成后会自动返回终端，即可开始使用。

基本用法

交互模式

在项目根目录下输入 claude 即可进入交互会话。

cd my-project
claude

在会话中，你可以用自然语言下达指令：

> 解释一下这个项目的结构
> 在 src/utils/helper.ts 中添加一个校验函数
> 运行测试并确保全部通过

单次执行模式

如果只想执行单个命令而不进入交互会话，使用 -p 参数：

claude -p "检查 package.json 中的依赖项，列出未使用的依赖"

管道输入

你也可以通过标准输入将数据传给 Claude Code：

cat error.log | claude -p "分析这个错误日志并给出修复建议"

git diff | claude -p "Review 一下这个 diff"

常用斜杠命令

以下是会话中可以使用的实用斜杠命令：

命令	说明
/help	显示帮助信息
/clear	清除对话历史
/compact	压缩并总结对话内容
/init	生成 CLAUDE.md 文件
/cost	显示当前会话的 token 用量

上手后可以先试试这些

1. 了解你的项目

> 解释一下这个项目的架构

Claude Code 会浏览所有文件，给出项目结构的概览。

2. 生成 CLAUDE.md

> /init

这会自动生成一个配置文件，告诉 Claude Code 你的项目规范和编码约定。

3. 修复 Bug

> 运行 npm test，找到失败的测试用例并修复

Claude Code 会自动完成运行测试、定位错误、修复代码的全流程。

权限设置

由于 Claude Code 可以编辑文件和执行命令，默认每次操作都会请求确认。你可以在设置中预先授权可信任的命令：

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ]
  }
}

总结

Claude Code 安装简单，让你直接在终端中使用 AI 编程助手。先在项目目录下运行 claude，试试代码解读或重构功能。后续文章将介绍与其他 AI 工具的对比以及更高级的工作流。