1. 为什么我把 Claude Code 塞进了 VS Code 和 Cursor 的终端里Claude Code 是 Anthropic 出的命令行 AI 编程助手能读你整个项目、改文件、跑测试、执行 git 操作适合已经习惯终端、又想让 AI 真正动手改代码的人。它不是一个插件式的补全工具而是一个能独立干活的 Agent。我平时主力是 Cursor但补全和 Chat 窗口处理跨文件重构时总差点意思于是把 Claude Code 挂在 IDE 内置终端里两边配合着用。实际场景是这样的Cursor 负责行内补全和快速改一个函数Claude Code 负责「把这个模块的鉴权逻辑重构成 OAuth2顺便补测试」这种需要读十几个文件的任务。你在 IDE 里打开终端输入claude就进入交互它和你的编辑器共享同一个工作目录改完的文件 Cursor 会立刻感知到。这篇不讲怎么装讲的是装完之后每天都会用到的几件事CLAUDE.md 怎么写、上下文怎么清、权限怎么放、IDE 侧怎么配。每一步都给可复制的片段和验证动作照着做就能跑通。如果你还没配好 API 入口后面第二节会给一个稳定的接入方式避免中途卡在鉴权上。先说清楚一个前提Claude Code 的体验好坏八成取决于你有没有把项目约定喂给它。默认状态下它对你的代码库一无所知每次都要重新摸索构建命令、测试框架、目录结构。CLAUDE.md 就是解决这个的它会在每次启动时自动加载进上下文。下面从最影响日常效率的配置讲起。2. CLAUDE.md 模板与上下文管理让 Claude Code 记住项目约定CLAUDE.md 是 Claude Code 的项目记忆文件放在项目根目录启动时自动读进上下文。它分两层项目级./CLAUDE.md给团队共享用户级~/.claude/CLAUDE.md放你个人的偏好。我试过不写这个文件直接用结果每次都要重复告诉它「我们用 pnpm 不用 npm」「测试用 vitest」写完之后这类重复对话基本消失了。生成模板最快的办法是在项目根目录执行/init它会扫描代码库自动生成一版。但自动生成的往往太泛我一般会手动改成下面这个结构你可以直接复制# 项目约定 ## 常用命令 - 安装依赖pnpm install - 本地开发pnpm dev - 构建pnpm build - 测试pnpm test - 单测某个文件pnpm test src/utils/format.test.ts - Lintpnpm lint --fix ## 代码风格 - 使用 TypeScript strict 模式禁止 any - 组件用函数式 hooks不用 class - 命名组件 PascalCase工具函数 camelCase常量 UPPER_SNAKE - 导入顺序node 内置 → 第三方 → 别名 / → 相对路径 ## 架构约定 - API 请求统一走 src/lib/request.ts不要直接 fetch - 状态管理用 zustandstore 放在 src/stores/ - 所有对外接口的类型定义在 src/types/api.ts ## 注意事项 - 改数据库 schema 前先确认 migrations 目录 - 不要动 .env 和 CI 配置文件 - 提交前必须跑 pnpm lint 和 pnpm test用户级文件我放的是跨项目通用的东西比如「回复用中文」「改完代码后列出改了哪些文件」「不要自动 git commit」。这样每个项目都能继承不用重复写。上下文管理这块最容易被忽略的是/clear。Claude Code 的对话是累积的你聊得越久历史上下文越长它越容易跑偏——比如你前面在改 A 模块后面问 B 模块它可能把 A 的假设带到 B 上。我的习惯是每完成一个独立任务就/clear一次重新开始。判断标准很简单如果接下来要做的事和刚才那件事没有文件上的关联就清掉。还有一个/resume用来找回历史会话会弹出一个选择器显示对话开始时间、初始提示和消息数量。有时候我清早了想翻回去看某个方案就用它。但别指望它当长期记忆用重要的结论我会让它写进 CLAUDE.md 或者项目里的 docs。上下文长度和成本直接相关。CLAUDE.md 写得太长也会占 token所以只放真正影响它决策的信息别把整个 README 抄进去。我一般控制在 100 行以内。3. IDE 侧配置VS Code、Cursor 终端与 settings.json 权限片段Claude Code 在 IDE 里的用法分两种。如果你用的是官方渠道直接在 VS Code 或 Cursor 的扩展市场搜 Claude Code 装插件即可。如果你和我一样走的是 API 接入的方式就不需要插件直接在 IDE 内置终端里执行claude就行它和编辑器共享工作目录改文件是实时的。先说 API 接入的配置。Claude Code 通过环境变量读取 Base URL 和 Key你在终端里这样设置export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的KeyKey 在控制台创建地址是 https://taotoken.net/api-keys 创建后复制出来。模型 ID 用claude-sonnet-4-5这类官方命名写进配置时三件套要齐Base URL、Key、Model ID缺一个都会报鉴权或模型找不到。然后是权限配置这是日常体验提升最大的一块。Claude Code 默认只读每次要改文件、跑命令都会停下来问你。任务一长你就一直在按确认。解决办法是开 bypassPermissions 模式。改~/.claude/settings.json{ permissions: { defaultMode: bypassPermissions } }或者临时用命令行参数claude --dangerously-skip-permissions我嫌每次敲参数麻烦就在~/.zshrc里加了个别名alias claudeclaude --dangerously-skip-permissions改完执行source ~/.zshrc生效。注意这个模式会让它自动执行所有操作包括删文件、跑脚本所以别在重要仓库里无脑开最好配合 git出问题能回滚。Cursor 这边有个细节它的内置终端默认可能不是登录 shell环境变量读不到。如果claude提示找不到 Key检查一下 Cursor 设置里的终端配置把默认 shell 设成/bin/zsh或/bin/bash确保~/.zshrc被加载。VS Code 同理在 settings.json 里配terminal.integrated.defaultProfile.osx: zsh。如果你用 Cline 或 CC Switch 这类工具管理多套配置记得 Base URL、Key、Model ID 三件套在每一套里都要写全切换时别只换 Key 忘了 URL。4. 验证请求从 /init 到一次真实重构的完整走查配好之后要验证链路是通的。第一步在项目根目录启动claude进去后先跑/init看它能不能正常扫描项目并生成 CLAUDE.md。如果这一步就报错多半是 Key 或 Base URL 的问题往下看第五节。第二步验证它能读文件。直接问读一下 src/lib/request.ts告诉我它导出了哪些函数正常的话它会调用文件读取工具把内容列出来。这一步能过说明文件访问没问题。第三步验证它能改文件。找个无关紧要的地方让它改比如在 src/utils/format.ts 里加一个 formatDate 函数接收 Date 返回 YYYY-MM-DD 字符串用项目现有的风格改完它会告诉你动了哪个文件。你回到 Cursor 里看文件应该已经变了而且没有语法错误。这一步验证的是写权限和代码风格理解。第四步验证它能跑命令。让它执行测试跑一下 pnpm test把失败的用例列出来如果权限模式配好了它会直接执行不会停下来问你。输出里能看到测试结果。第五步验证多模态。Claude Code 支持读图片你可以把报错截图拖进终端窗口macOS 支持拖放或者直接给路径分析这张截图里的报错/Users/me/Desktop/error.png它会读图并给出分析。这个在排查 UI 问题时特别省事不用你手打报错信息。走完这五步说明你的 IDE Claude Code 工作流是通的。之后就是日常使用遇到复杂任务时可以用自然语言触发深度思考比如「深入思考这个重构方案有没有边界情况没覆盖」它会进入更长的推理链但消耗的 token 也更多简单任务别用。5. 常见报错排查401、local proxy failed 与 reading choices接入阶段最容易撞的几个错我按实际遇到的频率排一下。401 UnauthorizedKey 不对或没读到。先确认环境变量在当前终端里生效执行echo $ANTHROPIC_API_KEY看有没有值。如果为空说明 shell 配置没加载检查~/.zshrc里 export 的位置或者 Cursor 终端是不是没走登录 shell。Key 本身也要确认没多复制空格重新去 https://taotoken.net/api-keys 生成一个最省事。local proxy failed / connection refusedBase URL 写错或网络不通。确认写的是https://taotoken.net/api不要带多余路径或结尾斜杠。如果公司网络有出口限制检查是否能正常访问该域名。reading choices of undefined这个通常出现在返回体结构和预期不符时多半是 Base URL 指向了不兼容的端点或者 Model ID 写错了。确认三件套一致Base URL 是https://taotoken.net/apiKey 是刚生成的Model ID 用claude-sonnet-4-5这类标准名。改完重启终端再试。OAuth 相关报错如果你之前登录过官方账号本地可能残留了 OAuth 凭证和 API Key 模式冲突。清掉~/.claude下的凭证缓存或者干脆用一个干净的配置目录启动。权限一直弹确认settings.json 没生效。检查文件路径是不是~/.claude/settings.jsonJSON 格式有没有写错比如多了逗号。改完重启 Claude Code。CLAUDE.md 没被加载确认文件名大小写正确必须是CLAUDE.md放在项目根目录。用户级的在~/.claude/CLAUDE.md。启动时它不会明确提示「已加载」你可以问它「你知道这个项目的测试命令是什么吗」来间接验证。排查思路就一条先确认环境变量再确认三件套最后看权限和文件路径。大部分问题出在前两步。6. 把工作流固定下来日常使用节奏与接入入口用顺之后我的日常节奏大概是这样早上打开 Cursor终端里claude启动先/clear保证干净上下文。接到任务先判断类型——单文件小改动用 Cursor 补全跨文件重构或需要跑测试的交给 Claude Code。任务描述里带上文件路径和期望结果它执行完我 review diff没问题就继续下一个任务再/clear。CLAUDE.md 我会随项目演进更新比如新增了构建脚本、换了测试框架就顺手改一行。它不需要一次写完美边用边补最实际。用户级配置里我固定了几条回复用中文、改完列出改动文件、不自动 commit。这几条省了很多来回。如果你还没配好接入Key 在 https://taotoken.net/api-keys 创建接入文档在 https://taotoken.net/doc 有完整的 Base URL 和参数说明。想先试试模型对话效果可以直接在 https://taotoken.net 的对话页面试。长期跑编码任务、需要稳定额度的看 Coding Planhttps://taotoken.net/coding-plan 。Claude Code 的具体接入参数在 https://taotoken.net/doc 里对着抄就行别自己猜路径。最后一句实在话Claude Code 的价值不在它多聪明而在它愿意一遍遍读你的代码、跑你的命令、按你的约定改。你把这些约定写进 CLAUDE.md把权限配顺它才真的像个能替你干活的助手而不是一个每次都要重新解释一遍的陌生人。
Claude Code 一些使用经验分享：从 CLAUDE.md 到 IDE 工作流
1. 为什么我把 Claude Code 塞进了 VS Code 和 Cursor 的终端里Claude Code 是 Anthropic 出的命令行 AI 编程助手能读你整个项目、改文件、跑测试、执行 git 操作适合已经习惯终端、又想让 AI 真正动手改代码的人。它不是一个插件式的补全工具而是一个能独立干活的 Agent。我平时主力是 Cursor但补全和 Chat 窗口处理跨文件重构时总差点意思于是把 Claude Code 挂在 IDE 内置终端里两边配合着用。实际场景是这样的Cursor 负责行内补全和快速改一个函数Claude Code 负责「把这个模块的鉴权逻辑重构成 OAuth2顺便补测试」这种需要读十几个文件的任务。你在 IDE 里打开终端输入claude就进入交互它和你的编辑器共享同一个工作目录改完的文件 Cursor 会立刻感知到。这篇不讲怎么装讲的是装完之后每天都会用到的几件事CLAUDE.md 怎么写、上下文怎么清、权限怎么放、IDE 侧怎么配。每一步都给可复制的片段和验证动作照着做就能跑通。如果你还没配好 API 入口后面第二节会给一个稳定的接入方式避免中途卡在鉴权上。先说清楚一个前提Claude Code 的体验好坏八成取决于你有没有把项目约定喂给它。默认状态下它对你的代码库一无所知每次都要重新摸索构建命令、测试框架、目录结构。CLAUDE.md 就是解决这个的它会在每次启动时自动加载进上下文。下面从最影响日常效率的配置讲起。2. CLAUDE.md 模板与上下文管理让 Claude Code 记住项目约定CLAUDE.md 是 Claude Code 的项目记忆文件放在项目根目录启动时自动读进上下文。它分两层项目级./CLAUDE.md给团队共享用户级~/.claude/CLAUDE.md放你个人的偏好。我试过不写这个文件直接用结果每次都要重复告诉它「我们用 pnpm 不用 npm」「测试用 vitest」写完之后这类重复对话基本消失了。生成模板最快的办法是在项目根目录执行/init它会扫描代码库自动生成一版。但自动生成的往往太泛我一般会手动改成下面这个结构你可以直接复制# 项目约定 ## 常用命令 - 安装依赖pnpm install - 本地开发pnpm dev - 构建pnpm build - 测试pnpm test - 单测某个文件pnpm test src/utils/format.test.ts - Lintpnpm lint --fix ## 代码风格 - 使用 TypeScript strict 模式禁止 any - 组件用函数式 hooks不用 class - 命名组件 PascalCase工具函数 camelCase常量 UPPER_SNAKE - 导入顺序node 内置 → 第三方 → 别名 / → 相对路径 ## 架构约定 - API 请求统一走 src/lib/request.ts不要直接 fetch - 状态管理用 zustandstore 放在 src/stores/ - 所有对外接口的类型定义在 src/types/api.ts ## 注意事项 - 改数据库 schema 前先确认 migrations 目录 - 不要动 .env 和 CI 配置文件 - 提交前必须跑 pnpm lint 和 pnpm test用户级文件我放的是跨项目通用的东西比如「回复用中文」「改完代码后列出改了哪些文件」「不要自动 git commit」。这样每个项目都能继承不用重复写。上下文管理这块最容易被忽略的是/clear。Claude Code 的对话是累积的你聊得越久历史上下文越长它越容易跑偏——比如你前面在改 A 模块后面问 B 模块它可能把 A 的假设带到 B 上。我的习惯是每完成一个独立任务就/clear一次重新开始。判断标准很简单如果接下来要做的事和刚才那件事没有文件上的关联就清掉。还有一个/resume用来找回历史会话会弹出一个选择器显示对话开始时间、初始提示和消息数量。有时候我清早了想翻回去看某个方案就用它。但别指望它当长期记忆用重要的结论我会让它写进 CLAUDE.md 或者项目里的 docs。上下文长度和成本直接相关。CLAUDE.md 写得太长也会占 token所以只放真正影响它决策的信息别把整个 README 抄进去。我一般控制在 100 行以内。3. IDE 侧配置VS Code、Cursor 终端与 settings.json 权限片段Claude Code 在 IDE 里的用法分两种。如果你用的是官方渠道直接在 VS Code 或 Cursor 的扩展市场搜 Claude Code 装插件即可。如果你和我一样走的是 API 接入的方式就不需要插件直接在 IDE 内置终端里执行claude就行它和编辑器共享工作目录改文件是实时的。先说 API 接入的配置。Claude Code 通过环境变量读取 Base URL 和 Key你在终端里这样设置export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的KeyKey 在控制台创建地址是 https://taotoken.net/api-keys 创建后复制出来。模型 ID 用claude-sonnet-4-5这类官方命名写进配置时三件套要齐Base URL、Key、Model ID缺一个都会报鉴权或模型找不到。然后是权限配置这是日常体验提升最大的一块。Claude Code 默认只读每次要改文件、跑命令都会停下来问你。任务一长你就一直在按确认。解决办法是开 bypassPermissions 模式。改~/.claude/settings.json{ permissions: { defaultMode: bypassPermissions } }或者临时用命令行参数claude --dangerously-skip-permissions我嫌每次敲参数麻烦就在~/.zshrc里加了个别名alias claudeclaude --dangerously-skip-permissions改完执行source ~/.zshrc生效。注意这个模式会让它自动执行所有操作包括删文件、跑脚本所以别在重要仓库里无脑开最好配合 git出问题能回滚。Cursor 这边有个细节它的内置终端默认可能不是登录 shell环境变量读不到。如果claude提示找不到 Key检查一下 Cursor 设置里的终端配置把默认 shell 设成/bin/zsh或/bin/bash确保~/.zshrc被加载。VS Code 同理在 settings.json 里配terminal.integrated.defaultProfile.osx: zsh。如果你用 Cline 或 CC Switch 这类工具管理多套配置记得 Base URL、Key、Model ID 三件套在每一套里都要写全切换时别只换 Key 忘了 URL。4. 验证请求从 /init 到一次真实重构的完整走查配好之后要验证链路是通的。第一步在项目根目录启动claude进去后先跑/init看它能不能正常扫描项目并生成 CLAUDE.md。如果这一步就报错多半是 Key 或 Base URL 的问题往下看第五节。第二步验证它能读文件。直接问读一下 src/lib/request.ts告诉我它导出了哪些函数正常的话它会调用文件读取工具把内容列出来。这一步能过说明文件访问没问题。第三步验证它能改文件。找个无关紧要的地方让它改比如在 src/utils/format.ts 里加一个 formatDate 函数接收 Date 返回 YYYY-MM-DD 字符串用项目现有的风格改完它会告诉你动了哪个文件。你回到 Cursor 里看文件应该已经变了而且没有语法错误。这一步验证的是写权限和代码风格理解。第四步验证它能跑命令。让它执行测试跑一下 pnpm test把失败的用例列出来如果权限模式配好了它会直接执行不会停下来问你。输出里能看到测试结果。第五步验证多模态。Claude Code 支持读图片你可以把报错截图拖进终端窗口macOS 支持拖放或者直接给路径分析这张截图里的报错/Users/me/Desktop/error.png它会读图并给出分析。这个在排查 UI 问题时特别省事不用你手打报错信息。走完这五步说明你的 IDE Claude Code 工作流是通的。之后就是日常使用遇到复杂任务时可以用自然语言触发深度思考比如「深入思考这个重构方案有没有边界情况没覆盖」它会进入更长的推理链但消耗的 token 也更多简单任务别用。5. 常见报错排查401、local proxy failed 与 reading choices接入阶段最容易撞的几个错我按实际遇到的频率排一下。401 UnauthorizedKey 不对或没读到。先确认环境变量在当前终端里生效执行echo $ANTHROPIC_API_KEY看有没有值。如果为空说明 shell 配置没加载检查~/.zshrc里 export 的位置或者 Cursor 终端是不是没走登录 shell。Key 本身也要确认没多复制空格重新去 https://taotoken.net/api-keys 生成一个最省事。local proxy failed / connection refusedBase URL 写错或网络不通。确认写的是https://taotoken.net/api不要带多余路径或结尾斜杠。如果公司网络有出口限制检查是否能正常访问该域名。reading choices of undefined这个通常出现在返回体结构和预期不符时多半是 Base URL 指向了不兼容的端点或者 Model ID 写错了。确认三件套一致Base URL 是https://taotoken.net/apiKey 是刚生成的Model ID 用claude-sonnet-4-5这类标准名。改完重启终端再试。OAuth 相关报错如果你之前登录过官方账号本地可能残留了 OAuth 凭证和 API Key 模式冲突。清掉~/.claude下的凭证缓存或者干脆用一个干净的配置目录启动。权限一直弹确认settings.json 没生效。检查文件路径是不是~/.claude/settings.jsonJSON 格式有没有写错比如多了逗号。改完重启 Claude Code。CLAUDE.md 没被加载确认文件名大小写正确必须是CLAUDE.md放在项目根目录。用户级的在~/.claude/CLAUDE.md。启动时它不会明确提示「已加载」你可以问它「你知道这个项目的测试命令是什么吗」来间接验证。排查思路就一条先确认环境变量再确认三件套最后看权限和文件路径。大部分问题出在前两步。6. 把工作流固定下来日常使用节奏与接入入口用顺之后我的日常节奏大概是这样早上打开 Cursor终端里claude启动先/clear保证干净上下文。接到任务先判断类型——单文件小改动用 Cursor 补全跨文件重构或需要跑测试的交给 Claude Code。任务描述里带上文件路径和期望结果它执行完我 review diff没问题就继续下一个任务再/clear。CLAUDE.md 我会随项目演进更新比如新增了构建脚本、换了测试框架就顺手改一行。它不需要一次写完美边用边补最实际。用户级配置里我固定了几条回复用中文、改完列出改动文件、不自动 commit。这几条省了很多来回。如果你还没配好接入Key 在 https://taotoken.net/api-keys 创建接入文档在 https://taotoken.net/doc 有完整的 Base URL 和参数说明。想先试试模型对话效果可以直接在 https://taotoken.net 的对话页面试。长期跑编码任务、需要稳定额度的看 Coding Planhttps://taotoken.net/coding-plan 。Claude Code 的具体接入参数在 https://taotoken.net/doc 里对着抄就行别自己猜路径。最后一句实在话Claude Code 的价值不在它多聪明而在它愿意一遍遍读你的代码、跑你的命令、按你的约定改。你把这些约定写进 CLAUDE.md把权限配顺它才真的像个能替你干活的助手而不是一个每次都要重新解释一遍的陌生人。
