Claude Code 入门

Anthropic 官方编程 CLI -- 让 AI 读懂你的整个代码库，跨文件修改，处理 Git 操作

你将学到什么

  • 安装并配置 Claude Code
  • 理解核心概念：CLAUDE.md、工具调用、Agent 模式
  • 掌握日常开发中最常用的命令
  • 了解 Claude Code 与 Codex CLI 的差异和互补关系

前置条件：有终端基础，会用 cd、npm 等基本命令

预计时间：15 分钟

一、什么是 Claude Code

Claude Code 是 Anthropic 推出的官方命令行编程工具。它不是普通的聊天机器人 -- 它能直接操作你的代码库：

  • 读懂整个项目 -- 自动分析目录结构、依赖关系、代码风格
  • 跨文件修改 -- 一次改动可以涉及十几个文件，自动保持一致性
  • 处理 Git -- 创建分支、提交代码、生成 PR 描述
  • 执行命令 -- 跑测试、装依赖、启动开发服务器

你只需用自然语言描述需求，Claude Code 会自主规划并执行。

二、安装

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

验证安装：

code
claude --version
# 输出类似: claude-code v1.x.x

Tip: 如果你用 bun，也可以 bun install -g @anthropic-ai/claude-code

三、获取 API Key

Claude Code 需要 Anthropic API Key 才能运行。有两种方式：

方式 A：按量付费（API Key）

  1. 前往 console.anthropic.com↗ 注册账号
  2. 进入 API Keys 页面
  3. 点击 Create Key，复制保存
  4. 首次启动 claude 时粘贴即可

方式 B：Max 订阅

Anthropic 提供 Max 订阅计划，包含 Claude Code 使用额度。适合重度用户，不用担心按量计费。

四、首次使用

进入任意项目目录，启动 Claude Code：

code
cd ~/projects/my-app
claude

首次运行会提示输入 API Key（只需一次，之后自动记住）。

进入交互界面后，试试这些：

code
> 分析一下这个项目的整体结构

> 帮我找到所有 TODO 注释

> 这个 useAuth hook 有什么问题？

Claude Code 会自动读取文件、分析代码，然后给你回答。

五、核心概念

CLAUDE.md -- 项目配置文件

每个项目根目录可以放一个 CLAUDE.md 文件，告诉 Claude Code 这个项目的上下文：技术栈、代码规范、架构决策等。

用 /init 命令可以自动生成：

code
> /init

Claude Code 会分析项目后生成一份初始的 CLAUDE.md。你可以随时手动编辑补充。

为什么重要：没有 CLAUDE.md，Claude Code 每次都要重新理解项目；有了它，Claude Code 一启动就知道上下文，回答更精准。

工具调用 -- AI 的手和脚

Claude Code 不只是"聊天"。它拥有一组工具：

工具能力
读文件查看任意源代码文件
写文件创建或修改文件
执行命令运行 shell 命令（测试、构建等）
搜索在代码库中全局搜索
Git 操作提交、分支、查看 diff

当你提出需求时，Claude Code 会自主决定使用哪些工具，按什么顺序执行。

Agent 模式 -- 自主完成复杂任务

Agent 模式是 Claude Code 最强大的能力。当你给出一个复杂需求时：

code
> 把这个项目从 Pages Router 迁移到 App Router

Claude Code 会：

  1. 分析现有路由结构
  2. 制定迁移计划
  3. 逐个文件修改
  4. 处理导入路径变更
  5. 运行测试验证

整个过程你可以观察，也可以随时介入调整方向。

六、常用命令

在 Claude Code 交互界面中，以 / 开头的是内置命令：

命令说明
/help查看所有可用命令
/init生成 CLAUDE.md 项目配置
/model切换模型（Opus / Sonnet）
/resume恢复上次对话
/compact压缩对话历史，释放上下文空间
/clear清空当前对话

实用技巧：

  • 长任务中途离开：直接关终端没关系，用 /resume 可以恢复（配合 tmux 更佳）
  • 上下文太长：用 /compact 让 Claude 总结之前的对话，腾出空间继续
  • 换模型：复杂任务用 Opus（更强但更慢更贵），简单任务用 Sonnet（快且便宜）

七、Claude Code vs Codex CLI

Claude CodeCodex CLI
厂商AnthropicOpenAI
模型Claude Opus / SonnetGPT-5.x Codex
费用API 按量计费 / Max 订阅ChatGPT Plus / Pro 自带
特点深度代码理解，擅长审查重构轻量快速，擅长快速编写
配置文件CLAUDE.mdcodex.md
适合场景代码审查、架构重构、复杂调试快速原型、批量生成、简单修改

它们不是竞争关系，而是互补关系。 最高效的工作方式是两个都用：

  • 用 Codex 快速写出初版代码
  • 用 Claude Code 审查质量、发现隐患、优化架构

这正是我们下一篇教程要讲的内容。

八、下一步

想同时用两个 CLI 工具实现"快速编写 + 深度审查"的双层保障？

双 CLI 工作流 -- tmux + Claude Code + Codex -->

Deep Dive：本地模型运行

进阶内容 -- 如果你有 Apple Silicon Mac 且配置了本地模型（如 MiniMax M2.5），可以让 Claude Code 完全离线运行。

Claude Code 默认连接 api.anthropic.com。通过设置 ANTHROPIC_BASE_URL 指向本地推理服务，所有请求都走本地，代码不离开电脑。

code
# 本地模式快捷命令（加到 ~/.zshrc）
alias cmp='ANTHROPIC_BASE_URL=http://localhost:8000 \
  ANTHROPIC_AUTH_TOKEN=local \
  ANTHROPIC_MODEL=claude-sonnet-4-5-20250929 \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude --dangerously-skip-permissions'
变量说明
ANTHROPIC_BASE_URL指向本地推理服务（如 oMLX）
ANTHROPIC_AUTH_TOKEN绕过 API Key 验证
ANTHROPIC_MODELClaude Code 识别的模型名
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁止非必要网络请求

本地模式完全免费、完全离线，但推理速度取决于你的硬件。详细部署指南参见 AI 部署教程。

外部资源