Claude Code 完整入门指南

Claude Code 是 Anthropic 官方推出的 AI 编程助手，可以直接读取你的代码库、 修改文件、运行命令、自动调试——真正实现「AI 自主编程」。 截至 2026 年，Claude Code 已进化为一个完整的 Agent 执行平台， 并提供多种使用入口，不再局限于命令行。

订阅要求

Claude Code 需要有效的付费订阅账户（Pro / Max / Team / Enterprise）。 免费账号无法使用。如尚未订阅，请先查看 Pro 订阅攻略。

什么是 Claude Code？

Claude Code 的核心能力：

  • 🗂️ 读取整个项目目录：理解代码库结构和上下文，不只看单个文件。
  • ✏️ 自动修改文件：直接对代码进行增删改查，并展示 Diff 供你确认。
  • 🧪 运行命令与测试：执行 shell 命令、跑测试、查看输出并自动修复错误。
  • 🔄 多步骤自主循环：完成「需求 → 实现 → 测试 → 修复」的完整自动化循环。
  • 🌐 内置浏览器：可直接访问文档页面和本地 dev server 预览（2026 新增）。
  • 🤖 子 Agent 并行：将大任务拆分，多个子 Agent 并行处理以提高效率。

选择哪种入口？

💻

CLI 终端

在系统终端运行 claude，功能最完整，支持脚本自动化和 CI/CD 集成。适合开发者重度使用。

推荐 · 本文重点
🖥️

桌面 App

官方图形界面客户端，支持可视化 Diff 审查、拖拽文件、多会话管理。适合不喜欢命令行的用户。

GUI · 零门槛
🔌

VS Code / JetBrains 插件

在编辑器侧边栏中使用，支持实时代码交互、@文件引用、内联 Diff 审阅。适合不离开 IDE 的用户。

编辑器集成
🌐

Web 版（claude.ai/code）

无需安装，直接在浏览器使用。功能相对受限，适合快速体验或轻量任务。

免安装

安装与登录（CLI 终端版）

国内用户必读：先配好终端代理

安装和登录都需要连接 Anthropic 服务器。终端默认不走系统代理， 必须先手动配置终端代理，否则安装和登录都会失败。

在安装前，先在终端执行（替换端口号为你的实际代理端口）：

# macOS / Linux
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

# Windows PowerShell
$env:https_proxy = "http://127.0.0.1:7890"
$env:http_proxy  = "http://127.0.0.1:7890"

建议将上述命令写入 ~/.zshrc 或 ~/.bashrc 永久生效。

📦

安装 Node.js 环境

Claude Code CLI 需要 Node.js 18+ 环境。访问nodejs.org下载 LTS 版本安装。安装完成后验证：

node --version  # 应输出 v18.x 或更高
npm --version
⚙️

安装 Claude Code CLI

全局安装：

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

也可以使用官方一键安装脚本：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell（以管理员身份运行）
irm https://claude.ai/install.ps1 | iex

安装完成后验证：

claude --version
🔑

登录 Claude 账号

在项目目录中运行 claude，首次启动会自动弹出浏览器授权登录页面。 使用你的 Claude.ai 账号（Pro / Max / Team）完成授权即可，无需手动配置 API Key。

cd /你的项目目录
claude
登录后切换账号

如需切换账号，在 Claude Code 对话框内输入 /login 命令即可重新授权。

✅

验证环境配置

成功登录后，运行 /doctor 命令让 Claude Code 自动检查环境配置， 它会诊断并提示任何潜在问题（代理、权限、依赖等）。

> /doctor
更稳定的方案：使用低延迟 VPS

Claude Code 的 API 调用对延迟极敏感，终端延迟过高会导致频繁超时。 建议使用延迟低的 VPS（如搬瓦工 CN2 GIA）来保证稳定响应。

搬瓦工 BandwagonHost低延迟 CN2 GIA

提供顶级 CN2 GIA 企业级路由线路，延迟极低、速度飞快，是硬核用户和开发者跑 Claude API 的首选。

立即查看

桌面 App 与 IDE 插件

🖥️ 官方桌面 App

前往 claude.ai/download下载对应平台（macOS / Windows）的安装包。安装后点击左侧导航栏的「Code」 图标进入编程模式，功能与 CLI 完全一致， 额外提供可视化 Diff 审查和多会话面板。

使用 Claude.ai 账号直接登录，无需额外配置。

🔌 VS Code 插件

在 VS Code 插件市场搜索 「Claude Code」 安装。 安装后在编辑器左侧出现 Claude Code 侧边栏，支持：

  • 用 @文件名 引用项目中的任意文件
  • 实时查看和接受/拒绝代码修改（内联 Diff）
  • 在 IDE 内完成授权登录，无需切换到终端

🌐 Web 版

访问 claude.ai/code， 登录后即可在浏览器中使用。适合临时体验，不能访问本地文件系统， 功能相比 CLI / 桌面版有所受限。

实战工作流示例

以下是一个使用 Claude Code CLI 重构项目的典型工作流：

# 进入项目，启动 Claude Code
cd my-react-app && claude

# 初始化项目（首次使用，自动生成 CLAUDE.md）
> /init

# 给出重构指令
> 帮我将所有 class component 重构为 function component，使用 hooks

# Claude Code 会：
# 1. 扫描项目，找到所有 class component 文件
# 2. 制定实现计划并请求你确认
# 3. 逐个重构，展示 Diff
# 4. 运行测试确认没有错误
# 5. 给出修改摘要
用 CLAUDE.md 定义项目上下文

在项目根目录创建（或通过 /init 自动生成）CLAUDE.md 文件， 写入你的项目架构、技术栈、编码规范和常用命令。 Claude Code 每次会话开始时会自动读取，给出更准确、更符合项目风格的建议。 这是官方最推荐的使用习惯。

使用技巧

  • 使用 /clear 命令清除对话历史，避免 context 过长影响准确度。
  • 使用 /compact 命令在保留重要信息的同时压缩上下文。
  • 使用 # 前缀快速给 Claude 添加项目级记忆（写入 CLAUDE.md）。
  • 复杂任务拆分为多个小步骤逐步执行，比一次性描述所有需求更可靠。
  • 使用 /doctor 诊断环境问题，它会自动检查并给出修复建议。
  • 使用 /login 切换账号，使用 /logout 退出登录。

常见问题 FAQ

🔧 运行 claude 一直 timeout / 无法连接怎么办？

终端默认不走系统代理，即使你开启了梯子，终端里的网络请求仍然直连失败。 必须手动为终端配置代理变量：

# macOS / Linux
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

# Windows PowerShell
$env:https_proxy = "http://127.0.0.1:7890"
$env:http_proxy  = "http://127.0.0.1:7890"

建议将上述命令写入 ~/.zshrc 让其永久生效，避免每次手动设置。 同时推荐使用低延迟 VPS（如搬瓦工 CN2 GIA）来降低 API 调用超时概率。

🔑 登录授权跳转浏览器后打不开怎么办？

浏览器授权页面访问的是 claude.ai，同样需要代理。确保：

  • 你的代理开启了「全局模式」或「TUN 模式」，让浏览器流量也走代理。
  • 如果浏览器打不开，可以复制终端中显示的授权 URL，在已开代理的浏览器中手动访问。
💳 必须用 Pro 订阅才能用 Claude Code 吗？

是的，Claude Code 需要 Pro、Max、Team 或 Enterprise 付费订阅， 免费账号无法使用。订阅费用包含在 Claude Pro 的 $20/月 中，无需单独付费。

如果你只是想体验 Claude Code 的编程能力，也可以通过 Anthropic API（按用量付费）接入， 在终端设置 ANTHROPIC_API_KEY 环境变量后运行 claude 即可，无需 Pro 订阅。

📏 context 越来越长，回答越来越差怎么办？

这是大模型的共性限制。推荐的应对策略：

  • 使用 /compact 命令压缩上下文（保留重要信息，裁剪冗余）。
  • 完成一个独立子任务后，用 /clear 清除上下文重新开始。
  • 用 CLAUDE.md 把关键上下文持久化，不依赖对话历史传递。
⚠️ Claude Code 会不会误删我的代码？

Claude Code 在修改文件前会展示 Diff 并请求你确认，不会静默修改。 即便如此，强烈建议在使用前确保项目在 Git 版本控制下， 这样即使出现意外也可以随时回滚。

🔀 Claude Code 和 API 调用有什么区别？

两种接入方式对比：

  • Claude Pro 订阅登录：月付 $20，额度包含在订阅内，操作最简单，推荐普通用户。
  • Anthropic API Key：按 token 用量计费，适合重度开发者或需要自动化 / CI 集成的场景，无需 Pro 订阅。

通过 API Key 使用时，在终端设置环境变量即可：

export ANTHROPIC_API_KEY="sk-ant-..."