Claude Code 是 Anthropic 出品的代理式编程工具：你用一句话描述任务，它会自己读项目代码、修改多个文件、运行命令和测试，并能直接提交 git、打开拉取请求（PR）。它可以在终端、VS Code 与 Cursor 扩展、JetBrains 插件、Claude 桌面应用和网页版 claude.ai/code 里使用，各入口共用同一个引擎。
截至 2026 年 9 月 30 日，想用它至少需要 Claude Pro 方案（月付 $20），或者一个按量计费的 Anthropic Console 账户，Free 方案不含 Claude Code。另外，官方中文文档明确写着：默认配置需要访问 claude.ai 和 Anthropic API 等端点，这些端点在中国大陆的网络环境中可能无法直接访问。
| 你想知道的 | 简短回答 |
|---|---|
| 是哪家公司的 | Anthropic，背后是 Claude 系列模型 |
| 能做什么 | 读懂整个代码库，跨文件改代码，跑命令和测试，提交 git、开 PR |
| 在哪里用 | 终端 CLI、VS Code / Cursor 扩展、JetBrains 插件、桌面应用、claude.ai/code |
| 要不要钱 | Free 不含；Pro 年付折合每月 $17、月付 $20；Max 每月 $100 起；也可用 Console 按 API 用量付费 |
| 用什么模型 | 直连 Anthropic API 时，opus 指向 Opus 5.5，sonnet 指向 Sonnet 5.5，fable 指向 Fable 5.1 |
| 中国大陆能不能直接用 | 官方提示所需端点可能无法直接访问，Anthropic 支持的国家和地区列表也不含中国大陆 |
Claude Code 能做什么
Claude Code 和只给建议的 AI 助手最大的不同，是它会自己动手。按 How Claude Code works 的说明，你交给它一个任务后，它会循环做三件事：收集上下文、采取行动、验证结果。比如你说“修复失败的测试”，它可能会先跑测试套件看哪里失败，读报错，搜索相关源文件并读懂代码，修改文件，再跑一次测试确认修好。每一步的结果都会影响下一步怎么走，中途你随时可以按 Esc 打断，或者直接输入新要求让它调整方向。
它能调用的内置工具大致分五类：
| 类别 | 它能做的事 |
|---|---|
| 文件操作 | 读文件、改代码、新建文件、重命名和整理目录 |
| 搜索 | 按模式找文件、用正则搜内容、浏览代码库 |
| 执行 | 运行 shell 命令、启动服务、跑测试、使用 git |
| 网络 | 搜索网页、查文档、查报错信息 |
| 代码智能 | 改完后看到类型错误和警告、跳转定义、查找引用（需要安装代码智能插件） |
放到日常工作里，常见用法有这几类：
- 补那些一直拖着的活：给没测试的代码写测试、修 lint 错误、解决合并冲突、升级依赖、写发布说明。
- 做功能、修 bug：用自然语言描述需求，它规划方案并跨文件实现；遇到 bug 时贴上报错或描述症状，它顺着代码库找根因再修。
- 处理 git：暂存改动、写提交信息、建分支、开 PR。在 CI 里还能配合 GitHub Actions 或 GitLab CI/CD 做代码审查和问题分类。
- 连接外部工具：通过 MCP（Model Context Protocol，一个把 AI 工具连到外部数据源的开放标准）读取 Google Drive 里的设计文档、更新 Jira 工单、从 Slack 拉数据。
- 写进脚本和流水线：
claude -p以非交互方式运行，可以接管道、放进 CI。 - 定时跑任务：Routines 在云端按计划运行，电脑关机也不影响；桌面应用的计划任务则在本机运行，能直接访问本地文件。
官方文档给出的两个命令示例，可以看出它的用法有多“直接”：
# 交互式：让它写测试、运行并修复失败项
claude "write tests for the auth module, run them, and fix any failures"
# 管道式：把改动过的文件列表交给它做安全审查
git diff main --name-only | claude -p "review these changed files for security issues"用 CLAUDE.md 让 Claude Code 按你的项目习惯工作
在项目根目录放一个 CLAUDE.md，写上编码规范、架构约定、首选库和审查清单，Claude Code 每次开新会话都会先读它；如果仓库里已经有给其他编程代理用的 AGENTS.md，它也能读。它还会在工作中自动记下你的偏好（自动内存），下次会话继续用。
更进一步的定制有三种：skills 把可重复的流程打包成命令（比如 /review-pr），团队可以共享；hooks 在它操作前后自动执行 shell 命令，例如每次改完文件就自动格式化；需要多人分工式的大任务时，可以让多个 Claude Code 代理并行处理不同部分，由一个主代理协调。想完全自己编排，还有 Agent SDK。
改动怎么受控：检查点和权限模式
它能改文件、跑命令，自然有人担心“会不会乱来”。官方设计了两道保险：
- 检查点：每次改文件前，它会先给当前内容做快照。出问题时连按两次 Esc 就能回退，或者直接让它撤销。检查点只管本地文件，对数据库、远程 API、部署这类外部操作无效。
- 权限模式：按 Shift+Tab 在几种模式之间切换。Manual 模式下改文件、跑命令前都会先问你；Accept edits 模式自动改文件，其他命令仍要确认；Plan 模式只看代码、提方案，不改源文件；Auto 模式由后台分类器拦下有风险的操作。v2.1.283 及以后的版本，终端和 VS Code 交互会话默认从 Auto 模式开始。
常用又可信的命令（比如 npm test、git status）可以写进 .claude/settings.json 的允许列表，免得每次都确认。
Claude Code 和 Claude 聊天、代码补全插件有什么区别
这三样东西名字相近，用途差别很大：
| Claude 聊天（网页 / 手机 / 桌面） | IDE 里的代码补全插件 | Claude Code | |
|---|---|---|---|
| 主要产出 | 文字回答和代码片段 | 当前文件里的补全建议 | 直接改好的文件、跑过的命令、git 提交 |
| 能看到的范围 | 你贴进或上传到对话里的内容 | 以当前文件为主 | 整个项目目录、终端、git 状态 |
| 谁来执行 | 你复制粘贴、自己运行 | 你逐条接受 | 它自己执行，你通过权限模式把关 |
| 额度 | 与 Claude Code 共用同一付费方案的额度 | 按插件自己的方案计 | 与 Claude 聊天共用 |
简单说，Claude 是模型和聊天应用，Claude Code 是一套让 Claude 模型能操作你项目的工具。常有人问“Claude Code 用的什么框架”，官方的说法是：模型负责推理，工具负责行动，Claude Code 就是包在模型外面、提供工具并管理模型所见上下文的那一层，英文叫 agentic harness。它不是某个开发框架，而是一个运行这种代理循环的程序；想用同样的工具和能力搭自己的代理，官方提供的是 Agent SDK。
和 Cursor、Codex 这类同样能改多文件的代理式工具怎么选，属于另一个问题，可以看 Claude Code vs Cursor 深度对比 和 Claude Code vs Codex 2026。
在哪里用：终端、IDE、桌面应用和网页
每个入口都连着同一个 Claude Code 引擎，所以 CLAUDE.md、设置和 MCP 服务器在各个入口里都有效。区别在于交互方式和代码在哪里执行：
| 入口 | 适合什么场景 | 前提 |
|---|---|---|
| 终端 CLI | 功能完整的命令行版本，适合习惯终端的人，也能进脚本和 CI | 在本机安装 Claude Code |
| VS Code / Cursor 扩展 | 在编辑器里看内联差异、用 @ 引用文件、审阅计划 | 在扩展市场搜索“Claude Code”安装 |
| JetBrains 插件 | IntelliJ IDEA、PyCharm、WebStorm 等，交互式看差异 | 从 JetBrains Marketplace 安装插件，另需装 CLI |
| 桌面应用 | 可视化看差异、并行跑多个会话、安排定期任务 | 应用自带 Claude Code，不用单独装 CLI；需要付费订阅 |
| 网页 claude.ai/code | 不装任何东西，在云端跑长任务，处理本地没有的仓库 | 浏览器登录；Claude iOS 和 Android 应用也能用 |
终端版的原生安装只要一行命令（macOS、Linux、WSL 用第一行，Windows PowerShell 用第二行）：
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iex装完打开新终端，运行 claude --version 能打印出版本号就说明装好了；然后进入项目目录运行 claude，第一次会提示登录。如果你设置了 ANTHROPIC_API_KEY 环境变量，它会跳过登录，改为让你确认是否使用这个密钥。Homebrew、WinGet 等其他安装方式、PATH 报错和 Windows 的细节，见 Claude Code 安装教程完整指南；登录卡住时可以对照 Claude Code 登录失败怎么办 排查。
要不要付费：Pro 及以上方案包含 Claude Code，额度与聊天共用
Claude Code 没有单独的订阅，它包含在 Claude 的付费方案里。截至 2026 年 9 月 30 日，Claude 定价页的情况如下：
| 方案 | 价格 | 是否含 Claude Code | 用量说明 |
|---|---|---|---|
| Free | $0 | 不含 | 只用于日常问答 |
| Pro | 年付折合每月 $17（一次付 $200），月付 $20 | 含 | 每个 5 小时窗口的用量至少是 Free 的 5 倍 |
| Max | 每月 $100 起 | 含 | 可选 Pro 的 5 倍或 20 倍用量（按每个 5 小时窗口计） |
| Team / Enterprise | 按席位计费 | 含 | 由组织统一管理 |
额度有三点要先弄清：
- 共用一个池子：你在网页、桌面、手机上和 Claude 聊天，与在终端里用 Claude Code，消耗的是同一份额度。聊天用得多，留给写代码的就少。
- 两层限制：用量按滚动的 5 小时窗口重置，付费方案在此之上还有每周限额。没有固定的消息条数，实际能用多少取决于对话长短、任务复杂度、选的模型和用到的功能。
- 用完之后：可以等重置、升级方案，或在付费方案里开启 usage credits，按标准 API 费率继续用。重度编码也可以直接改用 Console 账户按 API 用量付费。
Pro 和 Max 的差别、周限额的实际影响，见 Claude Max 和 Pro 限额差在哪 与 Claude Code 使用限制完整指南；还在找免费用法的话，Claude Code 免费试用还有吗 说明了目前的情况。
现在默认用哪些模型
Claude Code 用模型别名来选模型，不用记完整版本号。直连 Anthropic API 时，截至 2026 年 9 月 30 日，模型配置文档写明的对应关系是：
| 别名 | 指向 | 适合 |
|---|---|---|
sonnet | Sonnet 5.5 | 日常编码 |
opus | Opus 5.5 | 复杂推理、架构决策 |
fable | Fable 5.1 | 最难、耗时最长的任务 |
best | 能用 Fable 时同 fable，否则同 opus | 想直接用当前最强的 |
default | 恢复为你账户类型的默认模型 | 撤销手动指定 |
几个容易踩的点：
- Fable 5.1 和 Fable 5 是 Claude Code 里能力最强的模型，但它们不是任何方案的默认模型，要用
/model fable或claude --model fable主动选。按定价页说明，Fable 在 Max 上最多占用每周限额的 50%，在 Pro 上则走 usage credits。 - 新模型对版本有要求：Opus 5.5 需要 v2.1.280 及以上，Sonnet 5.5 需要 v2.1.284 及以上，旧版本运行
claude update升级。各版本变了什么见 Claude Code 更新日志。 - 会话中随时可以用
/model切换，启动时也可以用claude --model <名称>指定。 - 通过第三方云平台使用时，别名指向的版本不一样：Amazon Bedrock 和 Google Cloud 的 Agent Platform 上
sonnet指向 Sonnet 4.5，Microsoft Foundry 上opus和sonnet分别指向 Opus 4.6 和 Sonnet 4.5。需要新版本时要写完整模型名。
Claude Code 国内使用：在中国大陆能用吗
官方中文概述的原意是：默认配置下，Claude Code 的安装、登录和正常使用都需要访问 claude.ai 和 Anthropic API 等端点，而在中国大陆的网络环境中，这些端点可能无法直接访问；官方建议开始前先确认所在网络能连通这些服务。此外，Anthropic 支持的国家和地区列表里没有中国大陆。
官方支持的另一条路线是第三方提供商：终端 CLI、VS Code 和 JetBrains 可以改为通过 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或企业自建的 LLM 网关调用 Claude 模型。这条路线适合已经在用这些云平台的团队，用量按与对应平台的协议计费，模型别名也会指向上一节所说的版本。
阿里云百炼、DeepSeek 等平台也发布了“接入 Claude Code”的文档，做法是改环境变量，让 Claude Code 把请求发给这些平台，由它们的模型来回答。这时你用的仍是 Claude Code 这个工具，但背后的模型已经不是 Claude，Anthropic 文档里的模型说明、额度和效果都不适用，兼容性与计费以对应平台的文档为准。
按你的下一步找对应教程：安装、套餐、限额与对比
| 你接下来想做的 | 去看 |
|---|---|
| 在 Windows、macOS 或 Linux 上装好 | Claude Code 安装教程完整指南 |
| 决定买 Pro 还是 Max | Claude Max 和 Pro 限额差在哪 |
| 弄清周限额和 5 小时窗口 | Claude Code 使用限制完整指南 |
| 看看有没有免费用法 | Claude Code 免费试用还有吗 |
| 和 Cursor 比 | Claude Code vs Cursor 深度对比 |
| 和 Codex 比 | Claude Code vs Codex 2026 |
| 登录报 OAuth 错误 | Claude Code 登录失败怎么办 |
| 了解新版本改了什么 | Claude Code 更新日志 |
常见问题
Claude Code 是哪家公司的？
Claude Code 是 Anthropic 官方的产品，和 Claude 聊天应用出自同一家公司。官方文档站是 code.claude.com，价格和方案在 claude.com/pricing 查看。
Claude Code 免费吗，一个月多少钱？
不免费。Free 方案不含 Claude Code，最低需要 Pro（月付 $20，年付折合每月 $17），或者用 Anthropic Console 账户按 API 用量付费。桌面应用里的 Claude Code 同样需要付费订阅。
新手用 Claude Code 从哪里开始？
先按上面的方式装好并登录，在一个项目目录里运行 claude。最好懂一点命令行和 git，因为它的改动和提交都要你来把关。它本身就会解释自己怎么用，你可以直接问它“怎么设置 hooks”之类的问题；在项目里运行 /init 能生成一份初始的 CLAUDE.md，/doctor 能检查安装和配置问题。
Claude Code 会把我的代码传到哪里？
在本地模式下，代码在你自己的机器上执行，对话记录保存在本机 ~/.claude/projects/ 下的文件里；但模型推理需要把相关内容发给所用的模型服务（默认是 Anthropic API）。网页版 claude.ai/code 则在 Anthropic 管理的云端虚拟机里运行。团队对数据有要求时，应查看官方的数据使用和零数据保留说明。
