前言近日把玩 Claude Code圈内戏称Cloud Code终端智能助手一路试错颇多感悟。此工具能读本地代码、跑命令、自主改项目然文档诘屈难懂初上手极易踩坑。从程序本体升级、模型轮换、思考参数调设到更换API服务商、填写Token密钥乃至会话留存、权限管控我用DeepSeek网关转发接口时还遇Auto模式额外计费提示。遂整理成笔记把实操之法、踩过之坑一一记下供诸位同道参考。一、Claude Code 本体更新升级此包由npm全局安装一行命令便可升级本体npmupdate-ganthropic-ai/claude-code升级完毕执行此句查看版本核验更新是否成功claude--version须知升级之后本机旧配置、历史会话皆不会丢失。只是新增指令、权限新规须重启claude会话方能生效。二、API厂商切换 TokenAPI Key配置要旨Claude Code原生适配Anthropic官方接口亦可兼容中转网关、DeepSeek等OpenAI兼容接口。可借环境变量或是settings.json文件设置接口地址与密钥。配置优先级会话环境变量 settings.json 默认原生Anthropic地址方式1环境变量临时配置仅当前终端生效试新服务商首选Mac / Linux# 接口地址替换为你所用厂商网关地址exportANTHROPIC_BASE_URL[https://api.deepseek.com](https://api.deepseek.com)# API密钥填入平台拿到的tokenexportANTHROPIC_API_KEYsk-xxxxxxxxxxxxxxxxxxxx# 指定默认调用模型exportANTHROPIC_MODELdeepseek-v4-pro# 启动claudeclaudeWindows PowerShell$env:ANTHROPIC_BASE_URL[https://api.deepseek.com](https://api.deepseek.com);$env:ANTHROPIC_API_KEYsk-xxxxxxxxxxxxxxxxxxxx;$env:ANTHROPIC_MODELdeepseek-v4-pro;claude若切回Anthropic原生官方接口清空这两个环境变量即可Mac/LinuxunsetANTHROPIC_BASE_URLunsetANTHROPIC_API_KEY方式2settings.json全局永久配置本机全部项目生效长期使用推荐配置文件路径~/.claude/settings.json{apiKey:sk-xxxxxxxxxxxxxxxxxxxx,baseUrl:[https://api.deepseek.com](https://api.deepseek.com),model:deepseek-v4-pro,env:{ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-pro,ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-flash,CLAUDE_CODE_SUBAGENT_MODEL:deepseek-v4-flash},extra_body:{thinking:{type:enabled,budget_tokens:1024}}}注改完此配置文件务必重启claude会话新设置方才加载生效。子Agent可单独配轻量模型主模型负责复杂推理以此省下不少Token开销。三、模型切换四般法子按需取用模型切换优先级会话内指令 启动参数 环境变量 settings.json配置文件。日常编码最推荐会话内热切换不必重启上下文不会丢失。会话内热切换首选进入claude交互窗口直接敲命令查看全部可用模型/model指定模型直接切换示例/model deepseek-v4-pro若是原生Claude则填opus/sonnet/haiku即可。启动时指定模型开启会话之前在cli直接指定本次会话所用模型claude--modelopus环境变量临时生效当前终端exportANTHROPIC_MODELdeepseek-v4-flashclaude四、思考Thinking强度配置调控推理深浅思考强度便是reasoning_effort用以限定模型推理预算。架构重构、疑难bug排查便拉高档位简单脚本、注释编写则降档提速兼顾速度与资费。会话内快速调整思考档位/effort max可选档位max / high / medium / lowmax深思细想适合架构重构、疑难bug排查Token消耗更高high推理较强复杂业务开发首选medium默认均衡档位low浅思考响应快适合写注释、简单脚本部分版本兼容指令/think highsettings.json永久开启思考就是上一节贴出的json配置extra_body段budget_tokens为预留思考Token。此数值越大模型思虑越久切莫盲目设极大之数。避坑提醒思考功能有赖模型与接口网关。我用api.deepseek.com中转网关之时部分参数会受限。非原生Claude接口必先确认服务商是否支持extended thinking。五、权限模式详解Plan、Auto、Default此段最易踩坑可按ShiftTab在会话之内循环切换权限模式输入/permissions查看当前权限。模式核心能力适用场景关键点Plan模式 /plan仅读取文件、只读shell查询不会自动修改代码输出方案待人工核验大型重构、高危改动、审计AI行为无classifier分类器调用无额外分类器计费DeepSeek网关环境优先选用此模式acceptEdits允许自动修改项目代码删文件、跨目录操作、高危shell命令依旧弹窗确认日常业务开发最为均衡Auto模式全自动Agent自行决断自动执行命令、修改代码底层调用classifier分类器做安全校验快速小改动仅测试仓库可用原生Claude网关现已免除classifier计费若用DeepSeek中转网关分类器请求依旧计费便是开篇我遇到的提示Default默认模式每一次写文件、执行命令皆弹窗确认极度谨慎场景弹窗繁多开发迟缓彼时弹窗原文译意Claude Code自动模式计费新规直连原生Claudeauto模式分类器请求不再扣费。然我当前会话流量走api.deepseek.com网关不兼容此更新。功能无碍auto模式照常运转分类器请求依旧按旧规计费。若想用新版免费auto模式须令网关实现官方协议或是切回原生Claude API。简策复杂任务直接启用/plan模式避开classifier额外资费。启动命令直接进入plan模式claude --permission-mode plan单次prompt启用plan直接在输入框写/plan 帮我重构这个路由模块六、会话管理恢复历史会话、回滚、清理会话绑定本地项目目录不同文件夹会话相互隔离此乃众人常踩之坑。恢复历史会话# 唤出会话列表交互式选择推荐claude--resume#简写claude-r#一键恢复当前目录最近一次会话claude--continue#简写claude-c在claude交互窗口之中直接敲指令唤起会话选择器/resume会话选择器快捷键↑↓ 上下选择会话CtrlA 切换【当前项目会话 / 本机全部会话】空格预览会话内容Enter加载会话Esc关闭选择器要点在A项目创建的会话去到B目录执行--resume默认不可见按下CtrlA方能查看本机全部会话。若要保留原始会话不被覆盖可用/branch分叉一份新会话继续。常用会话维护命令/init于项目根目录执行扫描项目生成CLAUDE.md记录项目技术栈、编码规约。后续会话自动读取不必反复诉说项目背景。/compact压缩会话历史自动总结上下文留存项目记忆减少Token占用。长会话逻辑跑偏、响应卡顿之时可用。/clear清空当前对话历史但CLAUDE.md项目记忆保留适合切换全然无关的任务。/rewind会话连同文件状态回滚至历史检查点。AI改错代码一键回撤甚是好用快捷键EscEsc快速唤起。/btw xxx侧边临时发问不计入主上下文不污染主任务。临时查语法、小知识点专用。/cost查看当前会话Token消耗与资费统计谨防不知不觉耗费大量Token。/status /tasks查看子Agent后台任务列表多任务并行之时监控进度。七、管道快速调用不必进入交互式会话适合直接传入git diff、报错堆栈一次性得出结果不新建长会话。#评审git变更代码gitdiff|claude-preview this diff找出潜在bug、性能问题给出修改建议#分析测试报错堆栈npmtest21|claude-p定位报错根因给出最小修复代码#读取文件查找安全漏洞catapp.js|claude-p找出安全漏洞八、终端快捷键交互式会话内Esc立刻停止当前生成保留上下文改指令重跑EscEsc唤起rewind回滚菜单CtrlG唤外部编辑器写长PromptCtrlL重绘终端界面修复渲染乱码CtrlX CtrlK终止全部后台子AgentCtrlR检索历史输入命令九、代码工作流内置命令/review自动审查git变更文件检查边界case、代码规范、安全隐患。/simplify并行子Agent优化代码剔除冗余复用公共逻辑对照CLAUDE.md校验代码质量。/loop 2m /babysit本地循环监控任务持续观察测试、PR状态电脑休眠便停止。十、MCP插件扩展Model Context ProtocolMCP即模型上下文协议挂载各类外部工具Agent可直接操作git、数据库、Docker、Redis等。/doctor一键诊断查验网络、MCP服务、权限排查MCP连接异常。十一、记忆小技巧固化Prompt约束单行以#开头写入会话Claude Code会长久记住这条规则后续对话自动遵从不必每次重复约束。示例# 永远不要重写utils公共工具函数直接import复用禁止重复实现十二、工作区信任弹窗新项目打开总要授权文件夹首次在全新目录启动Claude Code会弹出信任工作区弹窗。此乃安全之制仅确认一次。Yes, I trust this folder信任目录留存记录后续不再弹窗授予读写与shell执行权限。No, continue without these permissions仅只读不可改文件、执行shell每次打开都会重复弹窗。配置存入.claude/settings.local.json不会提交到git仓库。若欲跳过信任校验⚠️风险极高只适合个人测试仓库。恶意仓库可自动执行脚本claude --dangerously-skip-permissions删除.claude/settings.local.json下次打开项目会再次触发授权弹窗。十三、实战避坑总结切勿一次性令AI通读整个巨型代码库优先执行/init生成CLAUDE.md按需读文件不然直接撑爆上下文。大规模重构优先Plan模式先阅方案人工核验确认后方执行防止破坏性改动。会话回答混乱、思路跑偏优先/compact更换任务直接/clear。开启thinking思考之时budget_tokens不可盲目设极大架构任务2048便足够数值越高资费越贵。使用中转网关务必留心Auto模式classifier计费之坑复杂重构优先Plan模式省下额外开销。批量重构拆成多段小任务每轮执行完毕跑单元测试再继续推进防止一次性大量改动难以排查问题。日常常用工作流吾平日所用cdmy-project claude --permission-mode plan进入会话依次执行/init /model deepseek-v4-pro /effort high写完代码后/review /simplify代码改错EscEsc回滚临时查询/btw查看开销/cost。文末此文仅为实操笔记非官方文档。AI生成内容或有谬误使用前务必自行核验。适合后端、全栈开发者上手Claude Code终端Agent。文风说明白居易文章贵在浅切不讲古奥辞藻叙事清楚把利弊说透如同《观刈麦》一般平实记事不堆砌生僻文言程序员读起来不费劲不是全篇古文。你看看这版是不是有白乐天那种“直白记事娓娓道来”的味道哪里觉得文言太重或者太轻我再微调。要不要我顺带写一段CSDN摘要放在文章开头和正文风格保持一致