Claude Code CLI 新手教程

第 1 章:什么是 Claude Code CLI?

Anthropic 的 Agent 式编程工具,在终端运行 claude,自动读代码、改文件、跑命令、处理 Git——像和同事对话一样写软件。

Agent 终端 CLI Anthropic Git

1Agent 式终端编程

Claude Code 是 Anthropic 推出的 AI 编程助手。与 IDE 里「补全下一行代码」不同,它是一个能自主行动的 Agent:理解整个代码库,跨文件编辑,执行 Shell 命令,并与 Git 等开发工具集成。

CLI 版在终端运行,启动命令为 claude。进入项目目录后,用自然语言描述任务即可:

cd your-project
claude

Claude 会按需读取项目文件,无需手动 @ 文件或粘贴上下文。它可以:

  • 读取与编辑文件——定位相关代码并修改
  • 运行 Shell 命令——执行测试、构建、脚本等
  • 处理 Git——查看 diff、提交、建分支、开 PR
  • 连接外部工具——通过 MCP 接入 Jira、Slack、数据库等
记住:Claude Code 是「能动手干活的 Agent」,不是只能补全代码片段的自动补全工具。

2与自动补全的区别

Claude Code(Agent)
  • 理解整个项目结构与上下文
  • 跨多文件规划并实现功能
  • 自主运行命令、测试、Git 操作
  • 用自然语言描述目标即可
  • 可配置权限模式(自动 / 手动确认)
传统自动补全
  • 预测光标处的下一行或下一段代码
  • 通常只作用于当前文件
  • 不能执行命令或操作 Git
  • 需要你逐行编写和审查

可以把 Claude Code 想象成一位坐在终端里的同事:你说「给 auth 模块写测试并跑通」,它会找文件、写代码、执行测试、修复失败——而不是只补全一个函数签名。

3多种形态,本教程聚焦 CLI

Claude Code 可在多种界面使用,底层引擎相同,CLAUDE.md、设置、MCP 等配置可跨界面共享:

界面说明
终端 CLI完整功能,本教程重点
VS Code / Cursor 插件编辑器内联 diff、@ 提及、计划审查
JetBrains 插件IDEA、PyCharm、WebStorm 等
桌面 App可视化 diff、多会话、定时任务
Web(claude.ai/code)浏览器运行,无需本地安装
Slack / GitHub Actions团队协作与 CI/CD 集成
本教程聚焦终端 CLI。若你更习惯图形界面,可另行查阅官方 Overview中的 VS Code、Desktop、Web 等入口。

4典型用法示例

# 一次性任务:写测试并修复失败
claude "write tests for the auth module, run them, and fix any failures"

# 交互模式里用自然语言
claude "commit my changes with a descriptive message"

# 管道:分析日志
tail -200 app.log | claude -p "Slack me if you see any anomalies"

常见场景包括:写功能与修 bug、补测试、重构、更新文档、代码审查、依赖升级、解决 merge conflict 等。下一章开始安装 CLI。

Claude Code CLI 新手教程 · 第 1 章