Claude Code 是 Anthropic 官方的终端编程 Agent（CLI 工具），在终端里以 Agent 方式完成读代码、改文件、跑测试、提交 PR 的完整闭环。2026 年已迭代至 v2.1.x，演进为工程化 AI 编程工具：支持多智能体编排、Skills 技能系统、MCP 工具接入与后台任务。本知识库即按 Claude Code 规范适配（.claude/ 目录 + CLAUDE.md）。

工具概述

• 定位：终端优先（terminal-first）的 Agent 编程工具，深度 agentic loop——读文件→规划→编辑→跑测试→修复，可长时间自主运行
• 开发者：Anthropic 官方；随 Claude 订阅（Pro $20/月含标准用量、Max $100/月 5x 容量）或按 API 用量计费
• 版本：2026-09 已到 v2.1.259（周更节奏，迭代极快）
• 形态：CLI（终端）+ Claude Code Desktop（桌面端，可预览运行应用、auto-fix PR）+ 移动端远程控制

核心功能

1. 终端 Agent 闭环：Shell/Git 权限可渐进放开，自动跑测试、提交 PR、按 review checkpoint 无人值守运行
2. 多智能体编排（Managed Agents）：Lead Agent 拆解任务，分配给最多 20 个并行的专家 Specialist Agent；另有评分器（Outcomes）与会话记忆提炼（Dreaming，研究预览）
3. Skills 技能系统：可移植、可复用的指令包（SKILL.md），教 Claude 你的工作流——本知识库的 color-expert / prompt-engineering-guide / ponytail 即此形态
4. MCP 集成：通过 MCP 协议接数据库、API、外部服务（见 AI基础概念-MCP协议）
5. 上下文治理：重构上下文机制解决大项目上下文溢出；200K+ 上下文（Fable 5.1 达 1M）
6. 命令系统：/ 斜杠命令 + @ 文件引用；新增 /design（artboard 工作流，研究预览）、/claude-api cost-optimize（成本五杠杆：缓存/token卫生/批处理/推理强度/模型选型）
7. 后台任务与远程控制：长时间自主进程 + 手机端 Remote Control、CI auto-fix（网页/手机直接触发修复）

安装与配置

安装（三选一）

# ① 官方脚本（推荐，Windows 用 Git Bash / WSL）
curl -fsSL https://claude.ai/install.sh | bash

# ② 包管理器
brew install --cask claude-code        # macOS
winget install ClaudeCode               # Windows

# ③ Claude Desktop App（最简单，claude.ai/download，Mac/Windows）

注意：npm i -g @anthropic-ai/claude-code 已废弃，官方不再推荐。

登录与验证

claude --version      # 验证安装
claude                # 首次启动进入登录流程（需 Claude 账号）

项目级配置（本知识库即范例）

项目根/
├── CLAUDE.md         ← 系统指令（项目大脑，启动自动生效）
├── .claude/
│   ├── commands/     ← / 自定义命令
│   ├── rules/        ← 路径作用域规则（如 wiki/**）
│   ├── skills/       ← 技能（目录联接到 skills/ 本体）
│   └── settings.json
├── .mcp.json         ← MCP 服务器配置
└── AGENTS.md         ← 兼容其他 Agent 的指令文件

基本操作

• 对话：claude 启动，自然语言下达任务；@file 引用文件、/command 调命令
• 权限模式：按需授权 Shell/Git 操作（默认逐步询问，可渐进放开为自动）
• 多模型：/model 切换（Opus / Sonnet / Fable 等）
• 会话管理：--resume 恢复会话、--continue 延续、/compact 压缩上下文
• 成本控制：/claude-api cost-optimize 分析 API 开销；Pro 订阅有标准用量上限，超限转 API 计费

进阶技巧

• CLAUDE.md 精简：官方建议 <200 行，详规拆到 .claude/rules/（本库 185 行 + wiki-writing 规则即此模式）
• Skills 制作：SKILL.md 带 frontmatter（name/description）自动触发；本体放 skills/、.claude/skills/ 建联接，随项目迁移
• MCP 接入：.mcp.json 声明服务器，让 Claude 调用外部工具（数据库/浏览器/内部 API）
• 多智能体：用 Managed Agents 拆大任务；Subagent 各自负责子模块
• hooks：生命周期钩子（PreToolUse 等）做权限管控与自动化
• 无人值守：--permission-prompts none + review checkpoints 跑长任务

优缺点对比

维度	Claude Code	Cursor	Cline（开源）	DeepSeek Harness
形态	终端 Agent	IDE 原生	VS Code 插件	Web UI / 插件 Agent
强项	深度 agentic、大重构、跨文件推理（SWE-bench 领先）	前端视觉调试、实时补全、上手快	全开源、任意模型、每步透明	万物皆插件、DeepSeek 生态
短板	纯 CLI 学习曲线陡、token 费用可能超预期	上下文判断粗、token 消耗高	自管理成本（配 API/模型）	Developer Preview，破坏性变更
计费	Pro $20 / Max $100 / API	$20-200/月	API 直付（省订阅费）	开源免费（模型另付）
适合	大重构、遗留代码库、复杂 bug	UI 密集、IDE 用户	控成本、要透明的用户	尝鲜插件生态

常见误区

1. 以为是"代码补全工具"：Claude Code 是 Agent——自主完成多文件任务，不是 IDE 里的自动补全（那是 Cursor 的活）
2. CLAUDE.md 越详细越好：官方建议 <200 行；写太多反而稀释注意力，细节拆到 rules/ 按路径加载
3. Skill 装进 .claude/skills/ 就完了：本体应在项目 skills/ 随库迁移，.claude/skills/ 用联接指向（本库标准做法）
4. 忽视成本：长会话、大上下文按 API 计费可快速超支——用 /claude-api cost-optimize 管理
5. 无人值守 ≠ 不用看：偶发误删文件、无限循环需人工叫停——用权限分级 + review checkpoint

一句话总结

Claude Code 是终端里的 Agent 而非代码补全：CLAUDE.md 宜少于 200 行，技能本体放 skills/ 并让 .claude/skills/ 只做联接，长任务必须保留人工检查点，否则成本与误删都会失控。

相关概念

• [AI-Agent-DeepSeek-Harness](/学习笔记/AI技术/AI Agent/AI-Agent-DeepSeek-Harness)
• [AI-Agent-概述与核心组成](/学习笔记/AI技术/AI Agent/AI-Agent-概述与核心组成)
• [AI-Agent-多智能体架构](/学习笔记/AI技术/AI Agent/AI-Agent-多智能体架构)
• [AI-Agent-主流框架对比](/学习笔记/AI技术/AI Agent/AI-Agent-主流框架对比)
• AI基础概念-MCP协议
• AI基础概念-MCP生态与服务器
• 提示词工程-Agent提示词技能
• [AI-Agent-学习路径与资源](/学习笔记/AI技术/AI Agent/AI-Agent-学习路径与资源)