官方教程中文版入门与安装
Claude Code 是什么
从官方定义理解 Claude Code 的产品定位、运行入口和基本工作方式。
Claude Code 是 Anthropic 的 agentic coding tool。按官方定义,它能读取代码库、编辑文件、运行命令,并和开发工具集成;入口不只在终端,也包括 IDE、桌面应用和浏览器。
对中文开发者来说,先把它理解成“能进入工程现场的编程 Agent”更准确:它不只是生成代码片段,而是可以围绕一个项目连续读文件、做计划、改代码、跑验证、处理 Git 工作流。
核心定位
- 它面向软件工程现场,而不是通用聊天。
- 它能在项目目录里读取上下文,不要求你手动复制每个文件片段。
- 它能改文件和执行命令,但这些动作受权限、审批和环境限制约束。
- 它能和 MCP、Hooks、Skills、Subagents、IDE、CI/CD、浏览器等能力组合。
- 它可以用于探索代码库、修 bug、加功能、写测试、改文档、做代码审查和自动化维护。
和普通聊天式 AI 的差别
普通聊天式 AI 的主要输入是你粘贴进去的文本。Claude Code 的官方设计重点是进入项目现场:它可以根据任务自己读取相关文件,必要时执行命令,并把结果继续纳入下一步判断。
这会改变工作流的重心:
- 你不再只问“这段代码怎么写”,而是描述项目目标和验收边界。
- Claude Code 先探索项目,再提出或执行改动。
- 改完后,它可以运行测试、lint、构建或 Git 命令来验证。
- 你仍然需要审查关键改动,尤其是权限、数据、依赖和发布相关动作。
官方入门路径
官方 quickstart 建议从一个真实项目目录开始:
cd /path/to/your/project
claude进入交互会话后,可以先让它理解项目:
what does this project do?再逐步给出更具体的任务:
add input validation to the user registration form官方示例强调一个原则:先让 Claude Code 理解上下文,再让它执行改动;不要把它只当成代码片段生成器。
你需要提前知道的限制
- Claude Code 需要可用账号:Pro、Max、Team、Enterprise、Claude Console,或企业云供应商接入。
- Claude.ai 免费计划不包含 Claude Code 访问权限。
- 本机 CLI、Desktop、IDE、Web 和 Mobile 是不同入口,能力覆盖不完全相同。
- 终端 CLI 是最完整的本地入口;Desktop 和 IDE 更偏视觉审查与编辑器集成;Web 更适合云端长任务。
- 权限模式、项目规则、命令执行环境和凭据优先级会直接影响实际效果。