# Claude Code CLI 入门指南：终端里的 AI 编程助手

> 一个命令行工具，让 Claude 成为你的结对编程伙伴。

---

你可能用过 Claude 网页版聊天，但你知道吗？Anthropic 官方推出了命令行工具 **Claude Code**，让 AI 直接在终端里帮你写代码、改 bug、重构项目。

这篇指南带你从零开始，掌握 Claude Code CLI 的核心用法。

---

## 一、Claude Code 是什么

Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具。它不仅能聊天，还能：

- **读写文件**——直接修改你的代码
- **执行命令**——运行测试、安装依赖
- **理解项目**——读取 CLAUDE.md 了解项目规范
- **连接 MCP**——扩展能力边界（数据库、API、自定义工具）
- **接管终端**——真正的自主操作，不只是生成代码片段

**和网页版的区别**：

| 维度 | 网页版 Claude | Claude Code CLI |
|------|--------------|-----------------|
| 代码执行 | 需要手动复制 | 直接修改文件 |
| 项目理解 | 每次解释上下文 | 自动读取项目结构 |
| 工具集成 | 无 | MCP 协议扩展 |
| 使用场景 | 单次问答 | 深度项目协作 |

---

## 二、安装

### 前置要求

- Node.js 18+
- npm 或其他包管理器

### 全局安装

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

安装完成后验证：

```bash
claude --version
# 输出: 2.1.xxx (Claude Code)
```

### 其他安装方式

```bash
# Homebrew (macOS)
brew install claude

# 从源码安装
git clone https://github.com/anthropics/claude-code
cd claude-code && npm install && npm link
```

---

## 三、认证登录

首次使用需要认证：

```bash
claude auth login
```

两种认证方式：

### 1. Claude 订阅账号（推荐）

选择 `Claude.ai account`，会打开浏览器登录你的 Claude 账号。登录后自动关联订阅额度。

### 2. API Key

选择 `Anthropic API key`，输入你的 API Key：

```bash
# 或通过环境变量
export ANTHROPIC_API_KEY=sk-ant-xxx
```

查看认证状态：

```bash
claude auth status
```

---

## 四、基本使用

### 启动交互会话

```bash
# 在项目目录启动
cd your-project
claude

# 指定模型
claude --model claude-sonnet-4-6

# 继续上次对话
claude --continue
```

### 非交互模式（管道/脚本）

```bash
# 单次执行并退出
claude -p "修复 src/index.ts 中的类型错误"

# 输出 JSON 格式
claude -p "分析这个项目的依赖" --output-format json

# 设置预算上限
claude -p "重构用户模块" --max-budget-usd 1.00
```

### 常用对话技巧

```bash
# 让 Claude 自己探索代码库
"看看这个项目的结构，告诉我主要模块"

# 指定文件
"读取 config/settings.json 并解释配置项"

# 执行任务
"给 User 模型添加一个 email 字段，并更新相关测试"

# 调试
"运行测试，分析失败的用例并修复"
```

---

## 五、MCP 配置

MCP（Model Context Protocol）让 Claude Code 连接外部工具，扩展能力边界。

### 添加 MCP 服务器

```bash
# 添加 HTTP 服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 添加本地 stdio 服务器（带环境变量）
claude mcp add my-server -e API_KEY=xxx -- npx my-mcp-server

# 从 Claude Desktop 导入
claude mcp add-from-claude-desktop
```

### 查看已配置的服务器

```bash
claude mcp list
```

### 常用 MCP 服务器推荐

| 服务器 | 用途 |
|--------|------|
| @anthropic-ai/mcp-server-filesystem | 文件系统访问 |
| @anthropic-ai/mcp-server-postgres | PostgreSQL 数据库 |
| @anthropic-ai/mcp-server-sqlite | SQLite 数据库 |
| mcp-server-github | GitHub 操作 |
| mcp-server-puppeteer | 浏览器自动化 |

### 项目级 MCP 配置

在项目根目录创建 `.mcp.json`：

```json
{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres", "postgres://localhost/mydb"]
    }
  }
}
```

首次使用时 Claude Code 会询问是否信任该项目级配置。

---

## 六、核心命令速查

### 会话管理

| 命令 | 说明 |
|------|------|
| `claude` | 启动新会话 |
| `claude -c` / `--continue` | 继续上次会话 |
| `claude -r` / `--resume` | 恢复历史会话（交互选择） |
| `claude -n "任务名"` | 设置会话名称 |

### 项目配置

| 命令 | 说明 |
|------|------|
| `claude mcp add` | 添加 MCP 服务器 |
| `claude mcp list` | 列出已配置服务器 |
| `claude mcp remove <name>` | 移除服务器 |
| `claude project` | 管理项目状态 |

### 调试诊断

```bash
# 健康检查
claude doctor

# 调试模式
claude --debug

# 调试日志写入文件
claude --debug-file debug.log
```

### 高级选项

| 选项 | 说明 |
|------|------|
| `--dangerously-skip-permissions` | 跳过所有权限检查（沙盒环境） |
| `--permission-mode auto` | 自动批准工具调用 |
| `--worktree` | 在隔离 git worktree 中工作 |
| `--agent <name>` | 使用自定义 agent 配置 |
| `--tools "Bash,Read,Edit"` | 限制可用工具 |

---

## 七、实战场景

### 场景 1：新项目快速上手

```bash
cd new-project
claude "分析这个项目结构，告诉我：1. 技术栈 2. 目录职责 3. 如何运行测试"
```

### 场景 2：Bug 修复工作流

```bash
claude "运行测试，找到失败的用例，分析原因并修复"
```

Claude Code 会：
1. 执行 `npm test`
2. 读取失败测试的堆栈
3. 定位问题代码
4. 生成修复并验证

### 场景 3：代码重构

```bash
claude "重构 auth 模块，把 callback hell 改成 async/await，保持功能不变"
```

### 场景 4：文档生成

```bash
claude "为 src/utils/ 目录下的所有函数生成 JSDoc 注释"
```

### 场景 5：CI/CD 集成

```bash
# 在 CI 中使用非交互模式
claude -p "检查代码风格问题并自动修复" --permission-mode auto
```

---

## 八、高级技巧

### 1. CLAUDE.md 项目规范

在项目根目录创建 `CLAUDE.md`，Claude Code 每次会话自动加载：

```markdown
# 项目规范

## 技术栈
- TypeScript + React
- Tailwind CSS
- Vitest 测试

## 代码风格
- 使用函数组件 + hooks
- 避免使用 any
- 测试覆盖率 > 80%

## 常用命令
- `npm run dev` 启动开发服务器
- `npm test` 运行测试
- `npm run lint` 代码检查
```

这样 Claude Code 就知道项目的"做事方式"。

### 2. 权限模式选择

| 模式 | 适用场景 |
|------|---------|
| `default` | 交互式使用，每次工具调用需确认 |
| `auto` | 自动批准所有操作，适合信任环境 |
| `plan` | 先规划后执行，适合复杂任务 |
| `acceptEdits` | 自动批准文件编辑，其他操作需确认 |

```bash
claude --permission-mode plan "重构整个用户模块"
```

### 3. Git Worktree 隔离

在独立分支工作而不影响主工作区：

```bash
claude --worktree feature-xyz "实现新功能"
```

### 4. 自定义 Agent

创建 `.claude/agents/reviewer.json`：

```json
{
  "description": "代码审查专家",
  "prompt": "你是一个严格的代码审查者。关注：安全性、性能、可读性。"
}
```

使用：

```bash
claude --agent reviewer "审查最近的提交"
```

### 5. 远程控制模式

允许其他终端或应用控制当前会话：

```bash
claude --remote-control my-session
```

---

## 九、最佳实践

### 1. 信任但验证

Claude Code 很强大，但不是完美的：

- 重大修改前先提交代码
- 复杂任务使用 `--permission-mode plan`
- 审查 Claude 生成的代码

### 2. 明确指令

模糊的指令得到模糊的结果：

```
# 差
"改一下那个函数"

# 好
"重构 src/utils/format.ts 中的 formatDate 函数，使用 date-fns 库，并添加单元测试"
```

### 3. 利用上下文

Claude Code 能读取项目文件，善用这一点：

```
"阅读 CLAUDE.md 了解项目规范，然后给 User 模型添加角色字段"
```

### 4. 分步骤处理复杂任务

```
# 先分析
"分析 auth 模块的架构问题"

# 再规划
"制定重构方案"

# 最后执行
"按方案重构，每完成一个模块运行测试"
```

### 5. 成本控制

```bash
# 设置单次预算上限
claude -p "大任务" --max-budget-usd 5.00

# 选择合适的模型
claude --model claude-haiku-4-5  # 简单任务
claude --model claude-sonnet-4-6  # 平衡
claude --model claude-opus-4-8  # 复杂任务
```

---

## 十、常见问题

### Q: Claude Code 会修改我的代码吗？

A: 默认模式下，每次文件修改都会请求确认。使用 `--permission-mode auto` 才会自动修改。

### Q: 如何撤销 Claude 的修改？

A: Claude Code 的修改就是普通的文件编辑，用 Git 撤销即可：

```bash
git checkout -- .
git restore .
```

### Q: API 调用费用如何计算？

A: 按 Claude API 标准计费。使用 `--max-budget-usd` 设置预算上限。

### Q: 能在 CI/CD 中使用吗？

A: 可以，使用非交互模式 `-p` 并设置 `--permission-mode auto`。

### Q: 和 Cursor、Windsurf 有什么区别？

A: Claude Code 是命令行工具，更灵活、可脚本化，适合终端重度用户。Cursor/Windsurf 是 IDE 集成，有更好的代码补全体验。

---

## 总结

Claude Code CLI 把 Claude 从聊天框解放到终端，真正成为能读写代码、执行命令、理解项目的 AI 伙伴。

**适合你，如果**：

- 习惯终端工作流
- 需要深度项目协作
- 想要自动化 AI 辅助
- 追求效率的工程师

**开始使用**：

```bash
npm install -g @anthropic-ai/claude-code
claude auth login
claude
```

然后在项目目录说一句：

> "看看这个项目，告诉我能帮你做什么。"

---

**相关资源**：

- Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code
- MCP 协议介绍：https://modelcontextprotocol.io
- Claude Code GitHub：https://github.com/anthropics/claude-code

你可能用过 Claude 网页版聊天，但你知道吗？Anthropic 官方推出了命令行工具 Claude Code，让 AI 直接在终端里帮你写代码、改 bug、重构项目。

Claude Code CLI 入门指南：终端里的 AI 编程助手

软件研发

人工智能

开发工具

编程语言

"ClaudeCodeCLI是Anthropic官方推出的AI编程命令行工具，可直接在终端修改代码、执行命令、理解项目结构。支持MCP协议扩展功能，比网页版更深度集成开发流程。安装简单，支持Node.js环境，提供交互式会话和脚本模式，可设置权限控制、预算上限。适合开发者实现代码重构、bug修复、文档生成等任务，是终端用户的AI编程利器。"

命令行工具

单元测试

SQL数据库

包管理器

文件系统

TypeScript

数据库

服务器

Agent

JSON

2026年中大促 | AI 领航 智绘未来

postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

"ClaudeCodeCLI是Anthropic官方推出的AI编程命令行工具，可直接在终端修改代码、执行命令、理解项目结构。支持MCP协议扩展功能，比网页版更深度集成开发流程。安装简单，支持Node.js环境，提供交互式会话和脚本模式，可设置权限控制、预算上限。适合开发者实现代码重构、bug修复、文档生成等任务，是终端...

Claude Code CLI 入门指南：终端里的 AI 编程助手-腾讯云开发者社区-腾讯云

Claude Code CLI 入门指南：终端里的 AI 编程助手

Claude Code CLI 入门指南：终端里的 AI 编程助手

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐