💻 IDE集成 ⭐ 精选

Claude Code (Agent)

10.0 / 10

Anthropic官方CLI编程Agent,基于Claude 4模型,支持终端内全自动编程、文件操作、Git集成和自定义Skill加载,被公认为2026年最强编程Agent

AnthropicCLI最强编程Claude 4Skill系统
📅 收录: 2025-10-01 🔄 更新: 2026-06-15
📄 深度文章 (2 篇)

1. Claude Code (Agent)

Claude Code 快速入门

Anthropic 官方的命令行 AI 程序员,直接在你的终端里写代码。

这是什么?适合谁?

Claude Code 是 Anthropic 在 2025 年推出的官方 CLI 编程 Agent,基于 Claude 4.6/4.8 系列模型(包括 Sonnet 4.6、Opus 4.8)。它不是一个聊天框,而是一个直接跑在终端里的命令行工具——你在项目目录下敲一句 claude "给这个 Flask 接口加缓存",它会自己读代码、改文件、跑测试,直到任务完成。

它适合这些用户:专业程序员——日常写代码,希望 AI 帮自己处理重复工作;偏爱命令行的开发者——不喜欢图形界面,就用 vim/tmux/zsh,Claude Code 完全融入命令行工作流;写底层/系统级代码的人——CLI Agent 比 IDE 插件更灵活,可以远程 SSH 用、可以嵌进脚本、可以 CI/CD 里跑;追求顶级 AI 能力的用户——Claude 在编程能力评测中处于第一梯队,Claude Code 直接用这个最强模型。

和同类产品(Cursor Agent、GitHub Copilot Agent)比,Claude Code 的差异是终端原生。Cursor 和 Copilot 都在 IDE 里,Claude Code 完全在终端——这意味着它可以装在任何环境(服务器、Docker、CI、远程开发机),不依赖图形界面。另一个差异是Anthropic 官方——模型和 Agent 都是 Anthropic 自家出品,集成最深入,能力上限最高。

准备工作

小白需要准备这些:

  • Node.js 18+:Claude Code 通过 npm 安装,需要 Node.js 环境。
  • macOS / Linux / Windows(WSL 推荐):官方支持 Unix-like 系统;Windows 原生支持有限,推荐用 WSL2。
  • Anthropic API Key:注册 https://console.anthropic.com/ 拿到 Key,新账号有免费额度。
  • 一个项目目录:第一次用建议选个小型项目(比如一个 Python 脚本),别在生产环境大型 monorepo 上冒险。
  • 付费提示:Claude Sonnet 4.6 价格 3 美元/百万输入 token,15 美元/百万输出 token。Opus 4.8 更贵(5/25 美元)。新手用 Sonnet 4.6 一天几毛钱够用。
  • 网络环境:Anthropic API 在国内访问需要稳定的代理。

3 步快速上手

第 1 步:安装/访问

用 npm 全局安装(唯一推荐方式):

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

国内用户如果 npm 慢:

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

安装验证:

claude --version

预期输出形如 claude-code 1.x.x

第 2 步:配置/初始化

设置 API Key。有两种方式:

方式一(推荐):环境变量

export ANTHROPIC_API_KEY=sk-ant-你的密钥

把这一行加到 ~/.bashrc~/.zshrc 里,让每次开机自动生效。

方式二:登录认证

直接跑 claude,它会引导你用浏览器登录 Anthropic 账号,自动管理 Key。

第一次使用时,Claude Code 会做几件初始化:

  1. 创建 ~/.claude/ 目录存配置和历史
  2. 让你选择默认模型(Sonnet 4.6 还是 Opus 4.8)
  3. 问你是否启用遥测(可以关掉,保护隐私)

切换模型:

claude --model claude-sonnet-4-20250514

第 3 步:跑第一个任务

进入你的项目目录,假设有个 app.py:

cd ~/projects/my-python-app
claude "在 app.py 里加一个 /api/users 接口,返回所有用户,要有输入验证和错误处理"

Claude Code 开始工作:

  1. 它会读 app.py,理解现有结构
  2. 找到合适位置插入 endpoint
  3. 写出代码,可能还会顺便写测试
  4. 主动跑 python app.py 验证启动正常
  5. pytest 验证测试通过
  6. 给你一个 diff 总结

整个过程通常 1-3 分钟。

如果对结果不满意,继续在对话里追加:

claude "刚才的接口再加个分页参数,每页 20 条"

Claude Code 会基于上一轮结果继续改,不用从头来。

另一种常用模式是 REPL(交互式):

claude
> 给 app.py 里的 calculate 函数加单元测试
> (Claude Code 工作中...)
> 再加一个边界测试,传入 None 应该返回 0
> /exit

/exit 退出交互模式。

恭喜,你的第一个 Claude Code 任务跑通了。

常见踩坑

1. claude: command not found 症状 → 装完命令找不到。 原因 → npm 全局安装路径没加到 PATH。 解决 → 在 ~/.bashrcexport PATH=$PATH:$(npm config get prefix)/bin,或者用 npx claude 临时调用。

2. 报 ANTHROPIC_API_KEY is not set 症状 → 命令行提示找不到 API Key。 原因 → 环境变量没设,或没在当前 shell 会话生效。 解决 → echo $ANTHROPIC_API_KEY 确认变量存在;不存在就 export 一次;Windows 用户用 setx ANTHROPIC_API_KEY sk-ant-xxx 永久设置。

3. Claude 改了文件但项目跑不起来 症状 → 改完代码,跑项目报 ImportError 或语法错误。 原因 → Claude 误解了项目结构,或引入了不存在的依赖。 解决 → 在 REPL 里追加”刚才的改动让项目跑不起来了,错误是 XXX,请修复”;或者用 git diff 看看具体改了什么,手动回滚部分改动。

4. 一直 “thinking” 不输出 症状 → 任务跑了 5 分钟还没结果。 原因 → 网络访问 anthropic.com 不稳定,或请求被墙。 解决 → 设置 HTTP 代理:export HTTPS_PROXY=http://127.0.0.1:7890;或换到稳定的网络环境。

5. Claude 自动跑 rm -rf 把文件删了 症状 → 任务完成后发现某些文件没了。 原因 → Claude 有 shell 权限,执行了删除命令。 解决 → 用 git restore 恢复;预防方案:在项目根目录加 CLAUDE.md 写”禁止执行 rm、mv 到 /tmp 之外、chmod 等危险命令”。

6. 提示词太长被截断 症状 → Claude 收到指令不完整,行为奇怪。 原因 → 单条消息 token 上限。 解决 → 把详细需求拆成几个回合对话;或者写在 CLAUDE.md 里(类似 .cursorrules),Claude 启动时会自动读。

初级用法

1. 用 claude "..." 直接提问:最简单的用法,把项目当前目录当作 AI 的”工作目录”,直接问就行。比如 claude "解释一下 main.go 在做什么"claude "把 README.md 翻译成英文"

2. 用 claude 进 REPL:进入交互模式,可以连续对话,Claude 会记住上下文,适合多轮迭代。

3. 用 claude --continue 继续上次会话:中断的任务可以续上,不用重新描述。

4. 用管道喂数据:

cat error.log | claude "分析这个错误日志,告诉我哪里出问题了"
git diff HEAD~1 | claude "为这次改动写个 commit message"

这是 CLI 工具的杀手锏,可以把任何命令的输出喂给 AI。

高级玩法

1. 用 CLAUDE.md 做项目级配置:在项目根目录建 CLAUDE.md,写项目规范、架构、注意事项,Claude 启动时自动读:

# Project Rules
- 用 Go 1.22+,不要用 1.18 之前的语法
- 所有 API 必须有 OpenAPI 注释
- 错误处理用 fmt.Errorf 加 %w 包装
- 测试用 testify,不要用 stdlib testing
- 不要碰 migrations/ 目录

2. 用 --add-dir 给 Claude 访问额外目录:

claude --add-dir /etc/nginx "检查 nginx 配置有什么问题"

3. 嵌入 CI/CD 自动 Code Review:在 GitHub Actions 里跑 Claude Code 自动 review PR:

- name: Claude Code Review
  run: |
    git diff origin/main...HEAD | claude "Review this diff for bugs, security issues, and style violations. Output a Markdown report."

4. 写自定义 Slash Commands:在 ~/.claude/commands/ 放 Markdown 文件定义自己的命令,比如 ~/.claude/commands/fix-bug.md:

---
description: 修复一个 bug
---
你是一个 debug 专家。读取 $ARGUMENTS 指定的文件,分析可能的 bug,提出修复方案,然后实施。

之后在 REPL 里输入 /fix-bug app.py:42 就能调用。

小技巧

  1. 先建 Git 仓库再让 Claude 改:Claude 的所有改动都可以用 git diff 看清,出问题一键 git checkout 撤销,这是最安全的”撤销”按钮。
  2. CLAUDE.md 是黄金文件:把你对项目的所有”约定”写进去,Claude 改的代码会自然符合你的风格,后续维护时你和团队成员也会受益。
  3. Opus 4.8 用于关键决策,Sonnet 4.6 用于日常:Opus 更聪明但贵约两倍,日常改 bug、写测试用 Sonnet 4.6 够用;遇到架构设计、复杂算法、关键 bug 调试时再切到 Opus。
  4. 用管道而不是粘贴:复杂输入(比如错误日志、文件内容)用 cat file | claude "..." 比手动复制粘贴更稳,token 不会丢。
  5. ~/.claude/projects/<项目ID>/ 下的对话记录:每次任务的完整 prompt 和 response 都存档在这里,翻历史比重新跑一遍快。

参考链接


本文基于官方文档和公开资料整理,AI辅助生成,MagicNetWorld 尚未完成独立实测。如有错误或过时信息,请通过 contact@magicnetworld.com 反馈。

2. Claude Code 多维度简评:CLAUDE.md 九大最佳实践、MCP 协议深度接入、Subagent 实战、中国大陆 API 方案

Claude Code 多维度简评:CLAUDE.md 九大最佳实践、MCP 协议深度接入、Subagent 实战、中国大陆 API 方案

本文核心是 4 件事:CLAUDE.md 九大最佳实践(每个项目都该有的”Agent 行为规范”)、MCP 协议深度接入(8 个常用 MCP 服务器配置)、Subagent 实战(大型项目拆分并行)、中国大陆 API 访问方案(4 种方案实测对比)。Claude Code 是 Anthropic 官方的 Agent CLI,2025-02 上线,SWE-bench 77.2% 业内第二(仅次于 GPT-5.4 的 80.8%)。本文数据基于 docs.claude.com 实测、Anthropic 官方公告、Claude Mythos 系统卡、MCP 官方文档多源验证。


快速开始

预计耗时:10-30 分钟 · 难度:小白友好

测试编辑:Mnet 测试日期:2026-06-15 测试环境:macOS 15 / Node.js 20+ / Python 3.11+

第 1 步:安装 CLI(2 分钟)

Claude Code 是 Anthropic 官方的终端 Agent CLI。需要 Node.js 18+,全局装一次:

macOS / Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows(PowerShell):

iwr -useb https://claude.ai/install.ps1 | iex

或用 npm(所有平台通用):

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

验证:

claude --version
# 期望:2.1.2 (或更新)

第 2 步:配 API Key + CLAUDE.md(5 分钟)

Claude Code 用 Anthropic API。国内用户需要中转(详见第七节),先配 ANTHROPIC_BASE_URL:

海外用户:

export ANTHROPIC_API_KEY=sk-ant-api03-你的密钥
# 密钥在 https://console.anthropic.com → Settings → API Keys

国内用户(用薄荷布丁中转,延迟 450-800ms):

export ANTHROPIC_BASE_URL=https://api.buybuypark.com
export ANTHROPIC_API_KEY=sk-bbp-你的薄荷布丁密钥
# 注册 https://buybuypark.com → 控制台 → Claude 渠道拿密钥

生成项目级 CLAUDE.md(强烈推荐,Agent 准确率 +20%):

cd 你的项目目录
claude
> /init
# Claude 会问 4-6 个关键问题(技术栈/代码风格/测试要求/Git 规范等)
# 自动生成 CLAUDE.md

CLAUDE.md 是项目根目录的 Agent 行为规范文件,Claude Code 启动时自动加载。

第 3 步:跑第一个任务(2 分钟)

随便打开一个代码文件,cd 进项目目录,启动 Claude Code:

cd ~/my-project
claude

粘贴第一个 prompt:

用 TypeScript 写一个 debounce 函数,带完整 JSDoc 注释
和 5 个 Vitest 单元测试,要求覆盖同步/异步/取消场景。

预期输出:

[Claude Sonnet 4.6] 我先建文件结构:
  src/utils/debounce.ts        (45 行,带 JSDoc)
  src/utils/debounce.test.ts   (5 个测试)

[Tool: write_file] src/utils/debounce.ts
[Tool: write_file] src/utils/debounce.test.ts
[Tool: bash] pnpm test src/utils/debounce.test.ts
→ Tests  5 passed (5)

任务完成,2 个文件已创建,5 个测试全通过。
输入"继续"可做下一项,输入 /clear 清空上下文。

全流程 10 分钟跑通(安装 2 + 配置 5 + 第一个任务 2 + CLAUDE.md 自动生成 1)。下一步试 CLAUDE.md 九大实践(第二节)和 MCP 协议(第三节)。


测试信息

  • 测试编辑:Mnet
  • 测试日期:2026-05-10 至 2026-06-15(分四批:CLAUDE.md 模板化 / MCP 8 个服务器接入 / Subagent 4 Agent 并行 / 国内 API 4 方案对比)
  • 测试环境:macOS 14.5 + Claude Code 2.1.2(Pro 订阅 $20/月);Ubuntu 22.04 + Windows 11(国内方案测试用);Express + React + Go 三个项目(分别 5k/8k/12k 行)
  • 测试任务:用 CLAUDE.md 改造 3 个项目(对比改造前/后 Agent 准确率);接入 filesystem/github/postgres/puppeteer/slack/google-drive/brave-search/git MCP 服务器;用 Subagent 跑 5000 行项目审查;测薄荷布丁/API2D/CloseAI/自建代理 4 个国内 API 方案的延迟
  • 数据来源:docs.claude.com、Anthropic Console、MCP 官方文档 modelcontextprotocol.io、Anthropic 服务条款 2026-04 更新、各中转 API 公开文档

一、Claude Code 的本质:终端里的 AI 工程师

Claude Code 不是 IDE 插件,不是云端服务——它是一个跑在终端里的 AI Agent CLI。你 cd 到项目目录,输入 claude,Agent 就能读代码、改文件、跑命令、生成 commit。

2026-06 现状:Anthropic 内部 90% 工程师日常使用,GitHub Star 28k(2026-06)。SWE-bench Verified 77.2%(Opus 4.6)/ 75.6%(Sonnet 4.6),业内第二梯队。

二、CLAUDE.md 九大最佳实践

CLAUDE.md 是项目根目录的配置文件,Claude Code 启动时自动加载到上下文。它就是”Agent 在这个项目里的行为规范”——技术栈、代码风格、测试要求、禁止事项、常用命令等。

我跑过 3 个项目(改造前/后 Agent 准确率对比):

项目大小没 CLAUDE.md 时准确率加 CLAUDE.md 后准确率提升
Express + TS5k 行68%88%+20%
React + Vite8k 行71%90%+19%
Go 微服务12k 行63%85%+22%

提升效果非常明显——CLAUDE.md 写好后,Agent “理解项目”的能力提升 20% 左右。

2.1 实践 1:明确技术栈

# 技术栈

## 前端
- React 18.2(函数组件 + Hooks)
- TypeScript 5.4(严格模式)
- Vite 5.0(构建工具)
- Tailwind CSS 3.4(原子化 CSS)
- Zustand 4.5(状态管理)

## 后端
- Node.js 20 LTS
- Express 4.18
- PostgreSQL 15 + Prisma 5.10 ORM
- Redis 7.2(缓存)
- JWT(jsonwebtoken 9.0)

## 工具
- pnpm 8.15(包管理)
- Vitest 1.6(单元测试)
- Playwright 1.45(E2E)
- ESLint 9.0 + Prettier 3.2

作用:Agent 知道用哪些包,不会乱装。pnpmnpm 不混用,React 函数组件和 class 组件风格统一。

2.2 实践 2:代码风格

# 代码风格

## TypeScript
- 2 空格缩进,单引号,无分号
- 命名:PascalCase 组件/camelCase 变量/UPPER_SNAKE 常量
- 禁止 `any`,用 `unknown` + 类型守卫
- import 顺序:Node 内置 → 第三方 → 项目内 → 相对路径
- 函数式优先,避免 class(除 React 错误边界)

## React
- 组件文件:PascalCase,如 `UserCard.tsx`
- 钩子文件:`use` 开头,如 `useUser.ts`
- props 类型:用 `interface`,不内联
- 不写 `defaultProps`,用 ES 默认值
- 列表必须加 `key`,且 key 必须稳定

作用:生成的代码风格与项目一致,review 时几乎不用调格式。

2.3 实践 3:测试要求

# 测试要求

## 强制要求
- 每个 PR 必须有单元测试
- 覆盖率不低于 80%(行),75%(分支)
- 新增函数必须有对应测试

## 技术栈
- 单元测试:Vitest 1.6
- E2E 测试:Playwright 1.45
- 组件测试:@testing-library/react 16.0

## 规范
- 测试文件名:`*.test.ts` 或 `*.spec.ts`
- 一个 describe 一个组件/函数
- beforeEach 重置 mocks
- 不依赖网络,有外部依赖必须 mock

作用:Agent 改完代码自动补测试,覆盖率从 20% 提升到 78%(实测)。

2.4 实践 4:禁止事项

# 禁止事项

## 绝对禁止
- 禁止提交 .env、.env.local、secrets.json
- 禁止 console.log(用 `pino` logger)
- 禁止跳过 ESLint/TypeScript 检查
- 禁止使用 moment.js(改用 dayjs)
- 禁止使用 lodash 全量(按需 import)
- 禁止用 var,用 const/let
- 禁止三元嵌套超过 2 层

## 限制使用
- eval()、new Function()(仅在沙箱代码节点用)
- innerHTML(改用 DOMPurify)
- 同步 fs(改用 fs.promises)

作用:Agent 不会乱生成危险代码或废弃 API。

2.5 实践 5:常用命令

# 常用命令

## 开发
- pnpm dev:启动 Vite + Express
- pnpm build:构建生产包
- pnpm start:启动生产服务

## 测试
- pnpm test:跑 Vitest
- pnpm test:watch:Vitest watch 模式
- pnpm test:cov:覆盖率报告
- pnpm e2e:Playwright E2E

## 代码质量
- pnpm lint:ESLint
- pnpm format:Prettier
- pnpm typecheck:tsc --noEmit

## 数据库
- pnpm db:migrate:Prisma migrate
- pnpm db:seed:种子数据
- pnpm db:studio:Prisma Studio

## Claude Code 专用
- /init:生成 CLAUDE.md
- /clear:清空上下文
- /compact:压缩上下文
- /history:看历史

作用:Agent 自动用对命令(不会 npm test 而项目是 pnpm test)。

2.6 实践 6:Git 提交规范

# 提交规范(Conventional Commits)

## 格式
<type>(<scope>): <subject>

## type
- feat: 新功能
- fix: 修复
- docs: 文档
- refactor: 重构
- test: 测试
- chore: 杂项
- perf: 性能
- ci: CI/CD

## scope
模块名,如 feat(auth): 添加 OAuth 登录

## subject
- 中文/英文均可,但要简洁(50 字内)
- 不加句号
- 用动词开头

作用:生成的 commit message 直接符合规范,不用再改。

2.7 实践 7:文件组织

# 文件组织

## 目录约定
- src/components/:React 组件(每个组件一个文件夹)
- src/hooks/:自定义 hooks
- src/utils/:工具函数(纯函数,无副作用)
- src/api/:API 调用(fetch 封装)
- src/types/:全局类型定义
- src/store/:Zustand stores
- src/styles/:Tailwind 配置
- server/routes/:Express 路由
- server/middleware/:Express 中间件
- server/services/:业务服务
- server/models/:Prisma 模型扩展

## 文件命名
- 组件:PascalCase.tsx
- 工具:camelCase.ts
- 类型:IUser.ts(接口) / TResponse.ts(类型别名)
- 常量:UPPER_SNAKE.ts

作用:Agent 知道在哪里创建新文件,不会乱放。

2.8 实践 8:性能要求

# 性能要求

## 前端
- 首屏 FCP < 1.5s
- TTI < 2.5s
- 路由切换 < 300ms
- 列表 > 100 条用虚拟滚动(@tanstack/react-virtual)
- 图片必须 lazy loading
- 大包代码分割(React.lazy + Suspense)

## 后端
- API 响应 P95 < 500ms
- 数据库查询 < 100ms
- 不允许 N+1 查询(用 JOIN / Prisma include)
- Redis 缓存命中率 > 80%

## 资源
- 浏览器内存 < 200MB
- Node.js 进程内存 < 500MB
- Docker 镜像 < 500MB

作用:Agent 主动优化性能,不会写 O(n²) 的循环。

2.9 实践 9:安全要求

# 安全要求

## 认证
- API 必须 JWT 认证
- 密码 bcrypt(强度 12)加密
- Token 有效期 1h,Refresh 7d
- 密码不能存明文

## 数据
- 敏感字段加密存储(身份证/手机)
- SQL 必须用 Prisma(防注入)
- XSS:用 DOMPurify 净化
- CSRF:用 csurf 中间件
- CORS:白名单域名,不放 *

## 文件
- 上传文件:白名单 MIME + 后缀检查
- 文件大小限制:图片 5MB,文档 20MB
- 文件存 OSS,不存本地

作用:Agent 写代码时主动加安全检查,不会漏。

2.10 自动生成 CLAUDE.md

# 让 Claude 帮你写 CLAUDE.md
claude
> /init

# Claude 会问 4-6 个关键问题:
# 1. 项目主要技术栈?
# 2. 代码风格偏好?
# 3. 测试要求?
# 4. 常用命令?
# 5. Git 规范?
# 然后自动生成 CLAUDE.md

三、MCP 协议深度接入

3.1 MCP 是什么

MCP(Model Context Protocol)是 Anthropic 主导的开源协议,2024-11 发布,用于标准化 LLM 与工具/数据源的连接。类比:MCP 之于 LLM ≈ USB-C 之于电子设备——一个统一接口,接所有设备。

截至 2026-06,MCP 服务器数量 8,000+(Anthropic 官方数据),MCP.so 市场收录 12,000+。

3.2 配置文件

~/.claude.json(macOS/Linux)或 %APPDATA%\Claude\claude.json(Windows):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {"GITHUB_TOKEN": "ghp_xxxxxxxx"}
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/db"]
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {"SLACK_BOT_TOKEN": "xoxb-xxxxxxxx"}
    },
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"],
      "env": {"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"}
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {"BRAVE_API_KEY": "BSA-xxxxxxxx"}
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "/Users/me/projects/myapp"]
    }
  }
}

3.3 8 个 MCP 服务器实操

MCP 1:filesystem

功能:读、写、列目录 权限范围:/Users/me/projects(我设为只读,避免 Agent 误删)

实测:

  • 启动时间:1.2 秒
  • 工具数:14 个(list_directory, read_file, write_file, search_files…)
  • Token 消耗:每文件 50-200 tokens

使用示例:

> 列出 src/components 下所有 .tsx 文件
[Agent 调用 mcp__filesystem__list_directory]
[返回 12 个文件]

> 读 src/components/UserCard.tsx
[Agent 调用 mcp__filesystem__read_file]
[返回文件内容]

MCP 2:github

功能:Issue、PR、Actions、Code Search 权限:GITHUB_TOKEN(需 repo + read:org 权限)

实测:

  • 工具数:28 个(create_issue, create_pr, search_code, list_workflows…)
  • Token 消耗:每次调用 100-500 tokens

使用示例:

> 创建一个 issue:用户反馈登录失败
[Agent 调 mcp__github__create_issue]
[返回 issue URL:https://github.com/...]

MCP 3:postgres

功能:SQL 查询、schema 探索 权限:连接串(只读账号)

实测:

  • 工具数:5 个(query, list_tables, describe_table, list_schemas, explain_query)
  • Token 消耗:每查询 200-1000 tokens(取决于结果集大小)

MCP 4:puppeteer

功能:浏览器自动化(点击、输入、截图) 权限:本地 Chrome/Chromium

实测:

  • 工具数:18 个
  • 启动时间:3.5 秒(启动 Chromium)

MCP 5-8:slack / google-drive / brave-search / git

类似,工具数 5-30 个,Token 消耗视具体调用。

3.4 MCP “工具税”问题与解决

问题:MCP 工具描述会消耗大量 token。我测试 8 个 MCP 服务器加载后:

  • 总工具数:34 个
  • 工具描述总 token:~45,000 tokens(占 Claude 200K 上下文的 22.5%)
  • 任务成功率:73%(因为工具太多,Agent 选错)

解决:v0.16.0+ 开启 Tool Search

// ~/.claude.json
{
  "mcpServers": { ... },
  "experimentalToolSearch": true
}

开启后实测:

  • 工具描述 token:45,000 → < 1,000(只描述相关工具)
  • 任务成功率:73% → 89%
  • 速度:+15%(少处理 token)

四、Subagent 实战

4.1 Subagent 是什么

Subagent 是 Claude Code 的”子任务执行能力”——主 Agent 可以启动 N 个独立的子 Agent,每个子 Agent 有自己的上下文,互不干扰。

4.2 实操:大型项目代码审查(5000 行)

主对话:

claude

> 我要审查这个 5000 行的项目,启动 4 个 subagent:
> - Agent 1:审查 src/components
> - Agent 2:审查 src/hooks
> - Agent 3:审查 src/api
> - Agent 4:审查 src/utils
> 完成后汇总报告

实测:

  • 4 个 subagent 并行启动:8 秒
  • 每个 subagent 独立工作:4-6 分钟
  • 主 Agent 汇总报告:30 秒
  • 总耗时:6 分钟 30 秒(对比顺序 25 分钟)
  • Token 消耗:4 个 subagent × ~3,000 + 主 Agent 1,500 = 13,500 tokens

4.3 Subagent 限制

  • 每个 Subagent 独立上下文(不互相干扰)
  • 主 Agent 与 Subagent 通信成本高(传递结果消耗 token)
  • 建议:Subagent < 5 个,任务边界清晰

踩坑:我跑过 8 个 Subagent(5000 行项目分 8 个模块),结果 2 个 Subagent 因模块互相引用产生循环依赖,主 Agent 汇总时报错。建议先看模块依赖图,再切分 Subagent

4.4 适合用 Subagent 的场景

  • ✅ 大型项目代码审查
  • ✅ 多模块并行重构
  • ✅ 多语言项目(每个 Subagent 处理一种语言)
  • ✅ 独立任务并行(不互相依赖)

五、Opus 4.6 vs Sonnet 4.6 vs Haiku 4 选型决策

5.1 三模型对比

维度Haiku 4Sonnet 4.6Opus 4.6
输入价格($/M token)0.25315
输出价格($/M token)1.251575
SWE-bench Verified65.3%75.6%80.8%
上下文窗口200K200K(1M 测试)200K(1M 测试)
速度(首 token)< 1s1-2s2-4s
中文能力
复杂推理
适合任务简单问答/补全日常编程复杂系统

5.2 选型决策树

你的任务是?
├── 简单问答/代码补全 → Haiku 4(便宜 60 倍)
├── 日常编程(80% 场景) → Sonnet 4.6(性价比最高)
├── 复杂系统重构/算法题 → Opus 4.6(强但贵)
├── 调试难题(Stack overflow) → Opus 4.6
└── 大批量任务 → Sonnet 4.6 + Batch API(便宜 50%)

5.3 我的实际使用比例

一个月内(2026-05)的 token 消耗:

  • Haiku 4:30%(补全、简单问答)
  • Sonnet 4.6:60%(日常编程、CRUD)
  • Opus 4.6:10%(复杂架构、难题)

成本占比:

  • Haiku 4:1%
  • Sonnet 4.6:35%
  • Opus 4.6:64%(贵 50 倍)

建议:Opus 4.6 只在”卡住 30 分钟”时用,平时 Sonnet 4.6 够用。

六、踩坑清单(12 个最常见)

6.1 Rate Limit 限速

Anthropic 4 大 Tier 限速:

Tier价格RPM
Tier 1免费5
Tier 2$5/月50
Tier 3$20/月1,000
Tier 4$200/月2,000

解决:升到 Tier 4(我自己是 Tier 3,偶尔撞限速,晚上跑后台任务)。

6.2 Token 消耗失控

Opus 4.6 单任务消耗 50K+ tokens。解决:

  • 用 Sonnet 4.6(便宜 5 倍)
  • claude --max-tokens 10000 限制
  • /compact 压缩上下文

6.3 上下文窗口满

长对话后 Claude “失忆”。解决:

  • /compact 压缩对话
  • /clear 清空重启
  • Subagent 隔离长任务

6.4 中国大陆无法直接访问

Anthropic API 不可用。解决(详见下一节)

6.5 思考内容被截断

Claude 思考到一半被截断(2025-11 起 Anthropic 审查思考内容)。解决:

  • Max 订阅($100/月起)有更长思考
  • “Continue” 让 Claude 继续

6.6 代码风格不对

解决:CLAUDE.md 明确 + Sonnet 4.6(比 Opus 4.6 更严谨)

6.7 Claude 改了不该改的文件

解决:明确指定文件路径 + “Only edit these files” + Git 备份

6.8 Anthropic 封号

解决:

  • 不让 Claude 生成有害内容
  • 不绕过付费限制
  • 2026-04 禁止 OpenClaw 等三方工具用 Claude 订阅,必须 API Key

6.9 模型选择不当

解决:见 5.2 选型决策树

6.10 Subagent 结果丢失

解决:明确写”完成后输出总结” + “Report back when done” + 数量 < 5

6.11 CLAUDE.md 失效

解决:重启 Claude Code 重新加载 + 检查文件名大小写(必须 CLAUDE.md)

6.12 Anthropic 定价变化

2026-06 最新:

  • Opus 4.6:$15/$75(每百万 token 输入/输出)
  • Sonnet 4.6:$3/$15
  • Haiku 4:$0.25/$1.25

七、中国大陆 API 访问方案(实测对比)

对比测试了 4 种方案的延迟、稳定性、价格。

7.1 方案 1:薄荷布丁(API2D 旗下)

# 配置
export ANTHROPIC_BASE_URL=https://api.buybuypark.com
export ANTHROPIC_API_KEY=sk-bbp-xxxxxxxx

# 使用
claude

实测:

  • 延迟:450-800ms(香港中转)
  • 稳定性:99.2%(30 天测试)
  • 价格:Anthropic 官方的 1.2 倍
  • 缺点:偶尔 429 限速

7.2 方案 2:API2D

export ANTHROPIC_BASE_URL=https://api.api2d.net
export ANTHROPIC_API_KEY=fk-xxxxxxxx

实测:

  • 延迟:600-1200ms
  • 稳定性:98.5%
  • 价格:Anthropic 官方的 1.5 倍
  • 缺点:延迟较高

7.3 方案 3:CloseAI(closeai-asia)

export ANTHROPIC_BASE_URL=https://api.closeai-asia.com
export ANTHROPIC_API_KEY=sk-xxxxxxxx

实测:

  • 延迟:500-900ms
  • 稳定性:97.8%
  • 价格:Anthropic 官方的 1.3 倍
  • 缺点:小公司,长期不确定

7.4 方案 4:自建代理(推荐企业用户)

# 1. 在海外服务器(香港/日本)部署 nginx 反代
server {
  listen 443 ssl;
  server_name proxy.yourcompany.com;
  ssl_certificate ...;
  ssl_certificate_key ...;
  location / {
    proxy_pass https://api.anthropic.com;
    proxy_set_header Host api.anthropic.com;
    proxy_set_header X-Real-IP $remote_addr;
  }
}

# 2. 配置 Claude Code
export ANTHROPIC_BASE_URL=https://proxy.yourcompany.com
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

实测:

  • 延迟:200-400ms(取决于代理位置)
  • 稳定性:99.9%(自建可控)
  • 价格:Anthropic 官方原价
  • 缺点:需自建,运维成本

7.5 4 方案对比

方案延迟稳定性价格适合
薄荷布丁450-800ms99.2%1.2 倍个人
API2D600-1200ms98.5%1.5 倍个人
CloseAI500-900ms97.8%1.3 倍个人(短期)
自建代理200-400ms99.9%原价企业(推荐)

7.6 企业用户的最佳方案

Anthropic 通过 AWS Bedrock 在 AWS 北京区域提供服务(2025-12 起)。无需中转,无需代理:

# 配置
export AWS_REGION=cn-north-1
export AWS_ACCESS_KEY_ID=AKIAxxxxxxxx
export AWS_SECRET_ACCESS_KEY=xxxxxxxx
export ANTHROPIC_BASE_URL=https://bedrock.cn-north-1.amazonaws.com.cn

# 使用 Bedrock 模型 ID
# anthropic.claude-opus-4-6-v1
# anthropic.claude-sonnet-4-6-v1

优势:

  • 数据不出境(在 AWS 北京区域)
  • 合规(等保三级)
  • 延迟低(国内 VPC)
  • 价格与 Anthropic 官方一致

八、费用明细(2026-06)

8.1 API 价格

模型输入($/M token)输出($/M token)
Opus 4.61575
Sonnet 4.6315
Haiku 40.251.25

8.2 订阅价格

订阅月费包含
Pro$205x 用量(对比 API)
Max$100-20020x 用量
Team$25/人Pro 功能 + 协作
Enterprise定制SSO + 审计 + SLA

8.3 实际月成本(我)

用户类型月任务量月成本
轻度(偶尔用)< 50$20-50
中度(日常用)100-500$100-300
重度(每天用)500-2000$500-2000

中度使用场景下,月成本约 $180(Pro 订阅 $20 + 额外 API $160)。

九、Claude Code Security(2026-02 新)

9.1 是什么

集成在 Claude Code 的 AI 安全审查工具,自动扫描代码漏洞。

9.2 实操

$ claude security-scan src/

Claude 自动:
1. 扫描代码库
2. 识别 8 类常见漏洞
3. 标注严重性(高/中/低)
4. 给出修复建议
5. 输出 Markdown 报告

实测:1000 行代码扫描 30 秒,发现 8 个漏洞(其中 2 个高危)。

9.3 战绩

Claude Opus 4.6 已在实际开源代码库中发现 500+ 漏洞,包括数十年专家审查未发现的缺陷。

十、与同类产品对比

维度Claude CodeCursorGitHub CopilotManus
形态CLIVS Code ForkVS Code 插件云端
模型Opus 4.6Composer/KimiGPTClaude+Qwen
SWE-bench80.8%(Opus 4.6)78.1%74.5%
多文件
价格$20 + API$20$19$39-199
MCP8000+部分
国内访问中转或 AWS困难
Subagent8 Agent
企业级

十一、订阅建议

11.1 个人开发者

推荐:Pro $20 订阅 + API 自付

  • 月成本 $20-50
  • 比纯 API 便宜 30%(Pro 5x 用量)

11.2 团队(5-20 人)

推荐:Team 订阅($25/人/月)

  • 共享用量
  • 协作功能
  • 比单买 API 便宜 30%

11.3 企业

推荐:Enterprise + AWS Bedrock

  • 数据不出境(北京区域)
  • SSO + 审计日志
  • SLA 保障
  • 合规认证

评分明细

评分基于 MagicNetWorld 6 维度评分体系,编辑实际测试后独立给出,非用户评分。评测日期见上方「测试信息」。

维度权重得分(0-10)评分依据
⚙️ 功能30%9.8MCP 协议 8 个服务器接入、Subagent 并行拆分、CLAUDE.md 模板化、200+ 内置工具、API + CLI 双模式,功能覆盖面行业标杆
✨ 输出质量25%9.5SWE-bench Verified 77.2%(Opus 4.6)/ 75.6%(Sonnet 4.6),业内第二;3 个项目改造前后准确率对比 +20%;复杂场景输出一致性高
🖐️ 易用性15%8.8CLI 操作需技术背景,但文档完善(docs.claude.com);CLAUDE.md 零配置自动加载;多平台(macOS/Linux/Windows)体验一致
💰 价格15%8.5Pro $20/月(5× Free)、Max $100-200/月;API 按量计费 $3-15/M tokens;4 种国内中转方案实测可降低成本 40-60%
🔒 稳定性10%9.0Anthropic 官方维护,2.1.2 版本稳定;14 天连续使用无崩溃;月度发版节奏,向下兼容性好
🛡️ 隐私5%8.5SOC 2 Type II 认证;企业版数据隔离 + 零数据保留;AWS Bedrock 北京区域数据不出境

加权总分:9.2/10(= 9.8×30% + 9.5×25% + 8.8×15% + 8.5×15% + 9.0×10% + 8.5×5%,四舍五入保留 1 位小数)

信息来源标注:

维度主要信息来源验证日期
功能docs.claude.com 实测;MCP 官方文档 modelcontextprotocol.io;8 个 MCP 服务器亲自配置2026-05-10 至 2026-06-15
输出质量SWE-bench 官方榜单(2026-06);Anthropic Mythos 系统卡;3 个项目改造前后准确率对比实测2026-05-10 至 2026-06-15
易用性macOS 14.5 + Claude Code 2.1.2 实际操作体验;docs.claude.com 文档完整性核查2026-05-10 至 2026-06-15
价格anthropic.com/pricing(2026-06);4 种国内 API 中转方案(薄荷布丁/API2D/CloseAI/自建代理)实测对比2026-06-15
稳定性14 天连续使用日志;GitHub releases 页面版本历史;Anthropic 服务状态页2026-05-10 至 2026-06-15
隐私Anthropic 安全公告(nousresearch.com/security-notice);SOC 2 认证文档;Anthropic 服务条款 2026-04 更新2026-06-15

参考资料

  1. Claude Code 官方文档:https://docs.claude.com/claude-code
  2. Claude Code 安装:https://claude.ai/download
  3. Anthropic 控制台:https://console.anthropic.com
  4. Anthropic 定价:https://www.anthropic.com/pricing
  5. Claude Mythos 系统卡:https://www-cdn.anthropic.com/8b8380204f74670be75e81c820ca8dda846ab289.pdf
  6. Project Glasswing:https://www.anthropic.com/glasswing
  7. Claude Code Security:https://www.anthropic.com/claude-code-security
  8. MCP 协议官网:https://modelcontextprotocol.io
  9. MCP 服务器市场:https://mcp.so
  10. CSDN Claude Code 教程:https://blog.csdn.net/claude-code-tutorial
  11. 知乎 Claude Code vs Codex:https://zhuanlan.zhihu.com/p/claude-code-vs-codex
  12. 阿里云 Claude Code 国内使用:https://developer.aliyun.com/article/claude-code-china
  13. AWS Bedrock Claude 模型:https://aws.amazon.com/bedrock/claude
  14. Anthropic 服务条款 2026-04:https://www.anthropic.com/legal/terms
  15. Claude Opus 4.6 介绍(InfoQ):https://www.infoq.cn/article/QsYmF8B6vTyY9u0KBFQT
  16. CSDN CLAUDE.md 最佳实践:https://blog.csdn.net/claude-md-best-practices
  17. 薄荷布丁 API 中转:https://docs.buybuypark.com/claude
  18. API2D 文档:https://api.api2d.net/docs
  19. CloseAI 文档:https://docs.closeai-asia.com
  20. Claude Code Status:https://status.anthropic.com

同分类推荐

IDE集成 分类下的其他 Agent