这篇按安装 → 登录配置 → 起项目 → 让 Claude 写代码 → 调试踩坑 → 进阶玩法的顺序走一遍跟着抄就能跑通。0. 先搞清楚Claude Code 是干嘛的Claude CodeAnthropic 出的命令行 AI 编程工具让你在终端里直接指挥 Claude读你的项目、改代码写新功能、修 bug、做重构帮你跑测试、定位报错生成脚本、文档、配置比起网页聊天它更像一个能直接动你仓库的 AI 同事做真实项目开发明显更顺手。1. 前置条件必须先装1.1 装 Node.js必需Claude Code 跑在 Node 上需要 Node 18建议直接上 20 LTS。打开官网 https://nodejs.org下 LTS 版推荐 20.x LTS双击安装包一路 Next默认就行装完验证打开 PowerShellWin X→ Windows PowerShell输入node-v npm-v能打印出版本号就成功。1.2 装 Git强烈建议Claude Code 会用 Git 读项目历史、生成 diff、开 PR。打开 https://git-scm.com/download/win下载后一路 Next验证git--version1.3 终端选哪个建议 Windows TerminalPowerShell、VS Code 内置终端、Git Bash 都能用但更推荐去 Microsoft Store 装一个Windows Terminal体验顺手不少。2. 安装 Claude CodeWindows2.1 npm 全局安装PowerShell 里执行npm install-g anthropic-ai/claude-code公司电脑常见的权限报错两种解法用管理员身份重开 PowerShell 再装或者改用npx临时跑见 6.2。装好后验证claude--version2.2 npm 太慢就换镜像可选npm configsetregistry https://registry.npmmirror.com npm install-g anthropic-ai/claude-code装完想换回官方源npm configsetregistry https://registry.npmjs.org3. 登录 / 配置 API KeyClaude Code 要连一个 Anthropic 接口才能调模型。手上没有合适 Key 的话可以用TeamoRouterhttps://teamorouter.com——它兼容 Anthropic 协议一个 Key 就能调 Claude、GPT、Gemini按量付费。3.1 拿一个 API Key打开 https://teamorouter.com注册登录进控制台 → API Keys点新建生成一个令牌复制 Key形如sk-xxxxxxxxx3.2 在 Windows 设环境变量PowerShell 里执行把 Key 换成你自己的$env:ANTHROPIC_BASE_URL https://api.teamorouter.com$env:ANTHROPIC_AUTH_TOKEN 你的Key几点注意用$env:这样设当前窗口立即生效不必重启Key 两边别多加空格或多套一层引号验证一下设没设上echo$env:ANTHROPIC_AUTH_TOKEN能回显你的 Key 就 OK。嫌每次开窗口都要重设把这两个值写进C:\Users\你的用户名\.claude\settings.json的env块以后启动自动加载{env:{ANTHROPIC_BASE_URL:https://api.teamorouter.com,ANTHROPIC_AUTH_TOKEN:你的Key}}4. 第一次运行 Claude Code先进到你想让它操作的目录比如你的项目文件夹cd D:\projects\my-app然后启动claude第一次启动它会检测当前目录是不是 Git 仓库问你要不要允许它读写文件可能让你选一个默认模型照提示选 yes 就行。5. 在项目里手把手写代码核心进入交互界面后体验类似聊天但需求要描述清楚。5.1 先让它摸清项目输入先快速过一遍项目结构告诉我技术栈、入口文件和主要模块。它会自动列目录、读 package.json / README给你一份结构总结。5.2 让它写一个功能需求尽量写明输入、输出、约束例如在 React 前端新增一个「用户列表」页面 - 路由 /users - 调后端 GET /api/users - 表格展示 name / email / role - 失败时弹出 toast 请直接改代码并告诉我动了哪些文件。它会读现有路由、组件、请求封装改完给你 diff 和说明。5.3 让它修 bug把报错原样贴上我运行 npm test 报错如下贴完整日志 请定位原因并修复。它会读测试、找到失败点、改代码再建议你重跑验证。5.4 让它重构例如src/utils/date.ts 里重复逻辑很多 帮我重构得更清晰可维护前提是所有现有单测仍然通过。6. 常用交互技巧6.1 用 引用文件 / 目录看一下 src/app.tsx帮我加一个 loading 状态。也可以引用整个目录扫一遍 src/components 里的所有组件。想看改动就说给我展示 diff。6.2 不想全局安装时的临时跑法npx anthropic-ai/claude-code7. Windows 常见坑7.1 提示 “claude 不是内部命令”原因是 npm 全局 bin 没进 PATH。查全局目录npm config get prefix把该目录下的node_modules\.bin加进系统 PATH重开终端再试7.2 请求超时 / 连不上先确认ANTHROPIC_BASE_URL填的就是https://api.teamorouter.com没填错公司网络有时会拦截外部请求换个网络环境或排查一下防火墙7.3 读写文件权限不足用管理员身份开 PowerShell或者把项目挪到你有完整权限的位置比如 D 盘的用户目录7.4 中文 / 带空格的路径异常少数工具链对中文目录支持不好。建议把项目放在纯英文路径例如D:\projects\my-app。8. 进阶玩法真正提效8.1 让它先出计划再动手先给我一份分步骤计划先别改代码。我确认后你再开始。这样不容易跑偏。8.2 配合 Git 出 PR按最佳实践新建一个 feature 分支完成修改后总结变更并给出 PR 描述。它会建分支、给 commit 信息建议、输出 PR 模板。8.3 让它顺手补测试这个功能需要单测覆盖请补齐并保证通过。8.4 多任务时列优先级按以下优先级逐项处理每项先说原因再改代码 1. 修复登录 bug 2. 重构 auth 模块 3. 补测试9. 推荐的几个使用习惯需求写清楚输入、输出、约束、边界都交代到先让它理解项目再让它动手每次改完自己跑一遍测试用 Git 记录方便回滚大改动先要计划10. 可以直接照抄的模板指令模板 1理解项目你现在在我的项目根目录。 请阅读 README、package.json 和关键入口文件给出 - 技术栈 - 目录结构说明 - 我该从哪个入口理解业务模板 2加功能需求…… 约束…… 先给实现计划先别改代码我确认后你再修改并展示 diff。模板 3修 bug我遇到 bug…… 复现步骤…… 错误日志…… 请定位原因 → 给出修复 → 补测试 → 给出验证方式。照着走下来原本要花一两天的活现在一小时就能收尾。赶紧拿自己的项目试一把。教程里用到的接口和模型价格见 https://teamorouter.com
Claude Code 保姆级上手教程（2026 版）
发布时间：2026/6/1 5:08:04
这篇按安装 → 登录配置 → 起项目 → 让 Claude 写代码 → 调试踩坑 → 进阶玩法的顺序走一遍跟着抄就能跑通。0. 先搞清楚Claude Code 是干嘛的Claude CodeAnthropic 出的命令行 AI 编程工具让你在终端里直接指挥 Claude读你的项目、改代码写新功能、修 bug、做重构帮你跑测试、定位报错生成脚本、文档、配置比起网页聊天它更像一个能直接动你仓库的 AI 同事做真实项目开发明显更顺手。1. 前置条件必须先装1.1 装 Node.js必需Claude Code 跑在 Node 上需要 Node 18建议直接上 20 LTS。打开官网 https://nodejs.org下 LTS 版推荐 20.x LTS双击安装包一路 Next默认就行装完验证打开 PowerShellWin X→ Windows PowerShell输入node-v npm-v能打印出版本号就成功。1.2 装 Git强烈建议Claude Code 会用 Git 读项目历史、生成 diff、开 PR。打开 https://git-scm.com/download/win下载后一路 Next验证git--version1.3 终端选哪个建议 Windows TerminalPowerShell、VS Code 内置终端、Git Bash 都能用但更推荐去 Microsoft Store 装一个Windows Terminal体验顺手不少。2. 安装 Claude CodeWindows2.1 npm 全局安装PowerShell 里执行npm install-g anthropic-ai/claude-code公司电脑常见的权限报错两种解法用管理员身份重开 PowerShell 再装或者改用npx临时跑见 6.2。装好后验证claude--version2.2 npm 太慢就换镜像可选npm configsetregistry https://registry.npmmirror.com npm install-g anthropic-ai/claude-code装完想换回官方源npm configsetregistry https://registry.npmjs.org3. 登录 / 配置 API KeyClaude Code 要连一个 Anthropic 接口才能调模型。手上没有合适 Key 的话可以用TeamoRouterhttps://teamorouter.com——它兼容 Anthropic 协议一个 Key 就能调 Claude、GPT、Gemini按量付费。3.1 拿一个 API Key打开 https://teamorouter.com注册登录进控制台 → API Keys点新建生成一个令牌复制 Key形如sk-xxxxxxxxx3.2 在 Windows 设环境变量PowerShell 里执行把 Key 换成你自己的$env:ANTHROPIC_BASE_URL https://api.teamorouter.com$env:ANTHROPIC_AUTH_TOKEN 你的Key几点注意用$env:这样设当前窗口立即生效不必重启Key 两边别多加空格或多套一层引号验证一下设没设上echo$env:ANTHROPIC_AUTH_TOKEN能回显你的 Key 就 OK。嫌每次开窗口都要重设把这两个值写进C:\Users\你的用户名\.claude\settings.json的env块以后启动自动加载{env:{ANTHROPIC_BASE_URL:https://api.teamorouter.com,ANTHROPIC_AUTH_TOKEN:你的Key}}4. 第一次运行 Claude Code先进到你想让它操作的目录比如你的项目文件夹cd D:\projects\my-app然后启动claude第一次启动它会检测当前目录是不是 Git 仓库问你要不要允许它读写文件可能让你选一个默认模型照提示选 yes 就行。5. 在项目里手把手写代码核心进入交互界面后体验类似聊天但需求要描述清楚。5.1 先让它摸清项目输入先快速过一遍项目结构告诉我技术栈、入口文件和主要模块。它会自动列目录、读 package.json / README给你一份结构总结。5.2 让它写一个功能需求尽量写明输入、输出、约束例如在 React 前端新增一个「用户列表」页面 - 路由 /users - 调后端 GET /api/users - 表格展示 name / email / role - 失败时弹出 toast 请直接改代码并告诉我动了哪些文件。它会读现有路由、组件、请求封装改完给你 diff 和说明。5.3 让它修 bug把报错原样贴上我运行 npm test 报错如下贴完整日志 请定位原因并修复。它会读测试、找到失败点、改代码再建议你重跑验证。5.4 让它重构例如src/utils/date.ts 里重复逻辑很多 帮我重构得更清晰可维护前提是所有现有单测仍然通过。6. 常用交互技巧6.1 用 引用文件 / 目录看一下 src/app.tsx帮我加一个 loading 状态。也可以引用整个目录扫一遍 src/components 里的所有组件。想看改动就说给我展示 diff。6.2 不想全局安装时的临时跑法npx anthropic-ai/claude-code7. Windows 常见坑7.1 提示 “claude 不是内部命令”原因是 npm 全局 bin 没进 PATH。查全局目录npm config get prefix把该目录下的node_modules\.bin加进系统 PATH重开终端再试7.2 请求超时 / 连不上先确认ANTHROPIC_BASE_URL填的就是https://api.teamorouter.com没填错公司网络有时会拦截外部请求换个网络环境或排查一下防火墙7.3 读写文件权限不足用管理员身份开 PowerShell或者把项目挪到你有完整权限的位置比如 D 盘的用户目录7.4 中文 / 带空格的路径异常少数工具链对中文目录支持不好。建议把项目放在纯英文路径例如D:\projects\my-app。8. 进阶玩法真正提效8.1 让它先出计划再动手先给我一份分步骤计划先别改代码。我确认后你再开始。这样不容易跑偏。8.2 配合 Git 出 PR按最佳实践新建一个 feature 分支完成修改后总结变更并给出 PR 描述。它会建分支、给 commit 信息建议、输出 PR 模板。8.3 让它顺手补测试这个功能需要单测覆盖请补齐并保证通过。8.4 多任务时列优先级按以下优先级逐项处理每项先说原因再改代码 1. 修复登录 bug 2. 重构 auth 模块 3. 补测试9. 推荐的几个使用习惯需求写清楚输入、输出、约束、边界都交代到先让它理解项目再让它动手每次改完自己跑一遍测试用 Git 记录方便回滚大改动先要计划10. 可以直接照抄的模板指令模板 1理解项目你现在在我的项目根目录。 请阅读 README、package.json 和关键入口文件给出 - 技术栈 - 目录结构说明 - 我该从哪个入口理解业务模板 2加功能需求…… 约束…… 先给实现计划先别改代码我确认后你再修改并展示 diff。模板 3修 bug我遇到 bug…… 复现步骤…… 错误日志…… 请定位原因 → 给出修复 → 补测试 → 给出验证方式。照着走下来原本要花一两天的活现在一小时就能收尾。赶紧拿自己的项目试一把。教程里用到的接口和模型价格见 https://teamorouter.com
![[开源] DRG边界病例错分识别与病案首页整改建议系统：面向医院信息科、医保办与病案室的自动化质控工具](http://pic.xiahunao.cn/yaotu/[开源] DRG边界病例错分识别与病案首页整改建议系统：面向医院信息科、医保办与病案室的自动化质控工具)
