Claude Code实战

概述关于AI IDE/插件请参考Vibe Coding、AI IDE/插件Claude Code生态AI IDE/插件二AI IDE/插件三GitHub36.3K Star2.3K ForkAnthropic推出的智能编程助手代理式编程工具简称CC可直接集成到终端环境中并通过自然语言命令实现更快编程。技术底层CC采用推理-验证-优化三级架构逻辑推理层通过递归链分解复杂需求安全验证层调用CodeQL引擎进行漏洞扫描自动生成SAST报告代码优化层结合OpenTelemetry标准注入监控埋点提升系统可观测性。特点直接集成终端无需额外服务器或复杂配置理解整个代码库能够分析项目结构和代码逻辑自然语言交互用普通话描述需求Claude帮你实现安全隐私设计直连Anthropic API无中间服务器实际操作能力真正执行文件编辑、Git操作等任务CC提供多种认证选项CCAnthropic Console通过OAuth登录控制台Claude Pro/Max订阅使用Chat端企业平台配置Amazon Bedrock或Google Vertex AI这里有两个概念控制台Chat端下面会再次出现。命令功能示例claude启动交互模式claudeclaude task执行一次性任务claude fix the build errorclaude -p query运行后退出claude -p explain this functionclaude -c继续最近对话claude -cclaude -r恢复之前对话claude -r/clear清除对话历史 /clear/help显示帮助 /helpexit或CtrlC退出 exit安装npminstall-ganthropic-ai/claude-code claude安装成功后如果出现command not found解决方法将D:\Program Files\nodejs\node_global加入PATH环境变量。又出现新问题或打开https://claude.ai出现如下提示解决方法切换地区出现如下界面则表示离成功只差一步。注意在切换区域时可能遇到的一个问题是Chat端能正常访问并发起Query但打开控制台因为要获取API Key失败。分析claude.ai和console.anthropic.com有不同的访问策略chat聊天界面地区限制相对宽松consoleAPI控制台地区限制更严格解决方法尝试不同的代理节点比如新加坡。通过Google授权登录claude.ai/chat成功并没有自动登录console.anthropic.com一说毕竟两个域名不同源还是要再次通过Google发起OAuth登录请求。又遇到新问题添加环境变量CLAUDE_CODE_GIT_BASH_PATHD:\Program Files\Git\bin解决问题。出现付费界面5美元。放弃一段时间后继续回来折腾。Claude Code是框架Claude模型是引擎。现在CC已经安装成功Claude系列模型无法使用其实更主要是太贵那能不能使用国内的性价比更高的模型呢当然能。还是Windows平台以DeepSeek为例配置系统环境变量ANTHROPIC_AUTH_TOKENsk-xxx ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic重启或新开终端测试命令claude --debug-file C:\temp\claude-debug.log --model sonnet 回复测试测试效果再打开DeepSeek开发者平台看到API使用量是今天测试成功。使用claude update更新到最新版本claude -c继续最近会话claude -r进入会话历史claude 查询启动带有初始提示的REPLclaude -p 查询以非交互模式运行一次性查询后退出claude -r [id]恢复指定会话或从列表中选择--add-dir添加额外的工作目录供Claude访问--allowedTools允许无需提示即可使用的工具列表--disallowedTools禁止使用的工具列表--model为当前会话设置特定模型--output-format指定非交互模式的输出格式(json/text)--dangerously-skip-permissions跳过所有权限提示谨慎使用# 设置opus 4.1为默认模型claude configsetmodel claude-opus-4-1-20250805# 查看所有设置claude config list# 更改设置值claude configset键值# 全局启用深色主题claude configset-gtheme dark# 添加到数组设置claude configadd键值# 创建带分支的新工作树gitworktreeadd../app-feature-bfeature main# 列出所有工作树gitworktree list# 删除工作树gitworktree remove路径# 权限绿通模式跳过权限检查claude --dangerously-skip-permissions示例# 分析项目summarize this project# 提交commit the generated CLAUDE.mdfile# 解释文件结构explain the folder structure# 修复Bugthere is a NPEinline77, fix it# 重构代码refactor the authentication module to use async/await instead of callbacks# 解决冲突helpme resolve merge conflicts# 编写测试writeunit testsforthe calculator functions# 性能优化analyze the performance of this code and suggest optimizations# 代码审查review my changes and suggest improvements# 添加注释addJSDoc comments to the undocumented functionsinauth.js# 触发深度思考I need to implement OAuth2 authentication. Think deeply about the best approach.# 加强思考深度think harder about edge cases we should handle# 思考安全问题think about potential security vulnerabilitiesinthis approach# 创建优化命令echoAnalyze the performance of this code and suggest three specific optimizations:.claude/commands/optimize.md# 使用自定义命令/project:optimize# 使用Git worktrees运行多个CC实例# 创建新工作树gitworktreeadd../project-feature-a-bfeature-a# 在新工作树中运行 Claudecd../project-feature-a# 管道操作catbuild-error.txt|claude-pexplain the root cause of this error# 添加到构建脚本npmrunlint:claude:claude -p look at changes vs main and report issues# 结构化输出claude-panalyze this code--output-format jsonanalysis.json# ~/.claude/settings.json全局设置{permissions:{allow:[Bash(npm run lint),Bash(npm run test:*)],deny:[Bash(curl:*)]}}命令和OpenAI Codex类似支持如下Slash命令/init生成cloud.md后续对话都会带上AI对项目理解更全面/compact压缩对话上下文丢掉不重要的历史内容省Token、更专注/clear清空对话开启新任务前用避免上下文干扰/think,/thinkhard,/thinkharder,/ultrathink控制Claude思考深度/help查看所有命令/status检查当前状态/reload重新加载配置或记忆文件/config查看或修改配置(如主题、模型)/review请求对PR、文件或代码块进行审查/model切换当前会话的AI模型/bug报告错误会将对话发送给Anthropic/cost显示当前会话的Token使用量和预估成本/memory编辑CLAUDE.md内存文件/permissions查看或更新权限规则/doctor检查CC安装的健康状况/resume恢复历史会话/vimVim模式/agents管理子代理/mcpMCP服务器/output-format指定输出风格快捷键快捷键功能说明!Bash模式前缀切换到命令行模式如!npm run dev结果也会写入上下文#记忆模式可写入项目级或用户级的长期记忆提及文件/文件夹\换行反斜杠 回车Esc中断ClaudeCtrlR完整输出/上下文CtrlV粘贴图片EscEsc历史导航ShiftTab自动接受yolo模式ShiftTabTab计划模式CtrlEsc在IDE中快速启动CtrlAltK插入文件引用MCPclaude mcpaddplaywright npx playwright/mcplatest claude mcpadd--transporthttp context7 https://mcp.context7.com/mcp钩子支持的钩子事件PreToolUse工具使用前PostToolUse工具使用后UserMessageIt用户消息时Stop停止时SessionStart会话开始SessionEnd会话结束上下文管理三类典型上下文场景标准对话模式、扩展思考模式、扩展思考工具调用模式标准上下文窗口多轮会话线性累积在最基本的对话场景中模型的上下文窗口以线性方式增长。每轮用户输入与模型输出都会完整地加入到上下文中并在后续被再次读取用于生成新的响应。特点上下文窗口是一个固定容量的滑动窗口如 200K token内容以“先进先出”方式更新超出容量的最早内容将被截断每一轮输入输出都会被完整记录使对话保持连贯性。适用场景标准多轮对话助手、问答任务等。限制点在长对话或内容密集型任务中容易触及 token 上限导致上下文截断影响模型表现。启用扩展思考推理能力增强Token使用量提升在某些高级模型架构中引入扩展思考(Extended Thinking)机制允许模型在生成最终输出前先进行一次内部推理或规划即思考块。技术上该机制在每轮对话的输出阶段会额外生成一段思考文本块(Thinking Block)用于模型内部结构化思考。在Claude的设计中这段内容虽然计入输出 Token但不会在后续对话中继续保留在上下文中。关键特性思考块仅计费一次在下一轮中自动从上下文中剔除释放上下文空间提高模型复杂推理时的Token利用率上下文计算公式被优化为context_window (input_tokens - previous_thinking_tokens) current_turn_tokens适用场景涉及复杂逻辑链、规划、多轮分析任务等。技术注意使用该机制时无需手动管理思考块的移除一般模型API自动处理。扩展思考工具调用多阶段推理与信息获取协同第三种更复杂的场景结合扩展思考与外部工具调用。常用于模型需要借助外部工具调用获取信息后再进行推理生成的任务中。处理流程如下第一轮用户输入→模型生成扩展思考工具调用请求第二轮将上一轮工具结果和原始思考块一并带入模型基于工具结果输出最终响应第三轮起清除前一次的思考块继续下一个对话或任务回合。上下文处理规则工具调用阶段必须保留对应的思考块以保持推理一致性API使用签名机制验证思考块的完整性若修改将导致响应错误思考块完成任务后即可自动剔除恢复常规上下文结构。适用场景外部知识调用、代码执行等工具调用的LLM应用。实际价值该机制实现深度推理与外部操作的无缝协作同时保持上下文高效利用。总结上下文窗口不仅仅是模型可见的输入历史更是一种资源调度机制决定模型能处理的内容广度和深度。理解并善用它是构建高质量LLM应用的关键。场景特点优势适用场景标准对话线性累积先进先出简单直观连贯性强普通多轮对话扩展思考思考块临时存在推理深度高但Token量增大深度分析扩展思考工具跨步骤协作调用工具工具调用与推理协同但token使用量增大业务Agent最佳实践配置文件为不同项目设置专门的配置文件模型切换根据任务复杂度选择合适的模型平衡性能和成本MCP合理使用MCP服务器扩展功能文件引用使用符号可以快速引用项目中的文件健康状态定期使用/doctor检查系统健康状态批量操作结合Bash模式!可执行系统命令利用钩子功能实现工作流自动化进阶原理CC的设计基于对LLM擅长什么和不擅长什么的深刻理解提示词和工具弥补模型的不足并帮助其在核心优势区大放异彩。问题之前安装成功突然没了解决方法重新安装。没有任何输出解决方法启动报错拓展参考Claude Code生态推荐阅读decoding-claude-code