一、Claude Code介绍Claude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具与传统的Chat模式不同Claude Code是一个能读项目、懂上下文、遵守约束的 AI 编程搭档。Claude Code 核心目标是理解你的整个项目并参与到真实的编码、修改和重构过程中主要具备三点特征上下文感知不仅理解单个文件而是理解整个项目结构工程化导向关注可维护性、规范、测试而不是一次性代码可定制行为通过 Skills技能包让 AI 遵守你的规则二、Coding Plan选择Claude Code官方支持通过 Claude订阅 或 Anthropic账户 开通使用同时也支持第三方提供商本文以第三方 Coding Plan阿里云百炼为例进行讲解。阿里云百炼是一站式大模型开发与应用平台集成了千问及主流第三方模型Qwen、GLM、Kimi、Minimax等为开发者提供了兼容Anthropic协议的API及全链路模型服务。PS业界存在多家兼容Anthropic协议的模型供应商可参考选择阿里云百炼、‌智谱AI、DeepSeek ... 等。三、Claude Code安装配置3.1、Claude Code 命令安装Claude Code 提供多种产品形态Terminal形态提供功能完成的CLI用于直接在终端中使用 Claude Code 编辑文件、运行命令并从命令行管理整个项目。针对Mac用户可选择 Brew 方式安装brew install --cask claude-code其他命令# 查看版本 claude --version # 更新版本 claude update3.2、Claude Code 配置 Coding Plana、初始化「流程配置文件」~/.claude/settings.jsonvi ~/.claude/settings.jsonb、编辑「流程配置文件」将 YOUR_API_KEY 替换为 Coding Plan 专属API Key保存配置文件重新打开一个终端即可生效。{ env: { ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_BASE_URL: https://coding.dashscope.aliyuncs.com/apps/anthropic, ANTHROPIC_MODEL: qwen3.6-plus, ANTHROPIC_SMALL_FAST_MODEL: qwen3.6-plus, ANTHROPIC_DEFAULT_HAIKU_MODEL: qwen3.6-plus, ANTHROPIC_DEFAULT_SONNET_MODEL: qwen3.6-plus, ANTHROPIC_DEFAULT_OPUS_MODEL: qwen3.6-plus, CLAUDE_CODE_SUBAGENT_MODEL: qwen3.6-plus } }c、 编辑或新增「客户端配置文件」~/.claude.json将hasCompletedOnboarding 字段的值设置为 true。该步骤可避免启动Claude Code时报错Unable to connect to Anthropic services。{ hasCompletedOnboarding: true }d、开启 Agent Team功能可选Agent Team 是 Claude Code 的实验性功能需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 环境变量为 1 来启用。变量设置方式{ env: { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1, ... } }3.3、Claude Code 命令使用打开终端并进入项目所在的目录cd path/to/your_project claude启动后授权 Claude Code 执行文件Quick safety check: Is This a project you created or one yuo trust? ... 1. Yes, I trust this folder 2. No, exit输入/status确认模型、Base URL、API Key 是否配置正确。然后可以在 Claude Code 中对话使用。3.4、Claude Code 常见命令命令说明示例/init在项目根目录生成 CLAUDE.md 文件用于定义项目级指令和上下文。/init/status查看当前模型、API Key、Base URL 等配置状态。status/model 模型名称切换模型。/model qwen3-coder-next/clear清除对话历史开始全新对话。clear/plan进入规划模式仅分析和讨论方案不修改代码。plan/compact压缩对话历史释放上下文窗口空间。compact/config打开配置菜单可设置语言、主题等。config四、IDEA 集成 Claude CodeClaude Code IDE 插件支持在 JetBrains 系列 IDE中使用。打开JetBrains扩展市场Setting - Plugins - Marketplace搜索 Claude Code 插件安装即可。安装后重启IDE单击右上角图标即可使用可通过/model 模型名称命令切换模型。五、实战演示5.1、简单任务a、发布任务任务描述“分析项目的 pom 依赖版本帮我升级到最新版本。注意先计划找我确认后再执行”补充说明为避免任务执行偏离目标强烈建议「先计划再执行」参考文末最佳实践建议。b、生成计划Claude Code 接受任务后将会按照要求生成执行计划扫描项目依赖关系并生成依赖树。使用 Web Search 查询 Maven Central获取每个依赖的最新版本。生成修改建议列出需要升级的依赖及其新版本。等待用户确认后修改 pom.xml 文件升级依赖版本。c、执行计划Claude Code 生成执行计划后将输出修改建议用户确认后 Claude Code 将会修改 pom.xml 文件进行依赖版本升级。5.2、复杂任务略更复杂的任务或使用方式可参考文末官网文档。六、最佳实践6.1、上下文管理及时清理 使用 /clear 定期重置对话防止旧的上下文干扰新任务并节省 Token。主动压缩使用 /compact 命令让 Claude 总结关键决策和修改的文件保留核心记忆。明确指定文件 提问时使用 引用文件如 write a test for auth.py避免模型无效扫描整个项目。善用子代理Sub-agents 对于大规模任务让 Claude 启动子代理执行。子代理完成任务后返回精炼结论保护主对话的上下文空间。6.2、先计划再执行启用 Plan 模式复杂任务前先分析方案不实际修改文件。快捷操作连续按两次 Shift Tab 进入 Plan Mode。提示词约束提示词明确要求“先输出详细实施计划经我确认后再修改文件”。降低试错成本确保逻辑闭环后再进行代码变更。6.3、沉淀项目核心知识编写 CLAUDE.md包含关键信息每次会话启动时自动加载CLAUDE.md建议填入构建命令、代码规范及工作流等通用规则。动态维护内容应简短易读仅记录广泛适用的全局约定并随项目演进持续补充新规则。6.4、扩展能力MCP 与 SkillsMCP安装成熟的 MCP Server连接外部服务。例如添加联网搜索MCP。Skills编写详细的 Skill 描述文案。Claude 决定是否调用该工具取决于对该工具用途的定义。例如添加视觉理解能力Skill。6.5、自动化守护Hooks使用 HooksHooks 是确定性规则。它在 Claude 工作流的特定生命周期节点如 PreToolUse 工具执行前校验等自动运行本地脚本确保关键校验或操作 100% 执行。配置方式运行/hooks进行交互式配置。直接编辑.claude/settings.json让 Claude 帮你编写如“编写一个在每次文件编辑后运行 eslint 的 hook”。6.6、建立自检闭环强制验证 要求 Claude 修改代码后必须运行相关的测试用例如 pytest 或 npm test。