前言2025-2026 年AI 编程工具进入了全新的 Agent 时代。不同于传统的代码补全工具新一代 AI Coding Agent 能够直接理解整个代码库、自主规划任务、跨多文件执行修改甚至帮你完成从 Issue 到 Pull Request 的全链路开发工作。Anthropic 推出的 Claude Code 正是这一趋势的代表产品。它不是 IDE 插件而是一个运行在终端里的原生 AI 编程智能体。截至 2026 年 7 月Claude Code 已经覆盖了终端、VS Code、JetBrains、桌面应用、Web 和 Slack 六大使用场景满足不同开发习惯的需求。本文将带你从零开始完整掌握 Claude Code 的安装、配置与核心使用方法并重点介绍国内用户如何免费使用——无需订阅 Claude Pro只需接入第三方模型的 API按 Tokens 计费即可。一、Claude Code 是什么Claude Code 是 Anthropic 开发的终端原生 AI 编程工具。和 GitHub Copilot、Cursor 这类 IDE 内嵌插件不同Claude Code 直接运行在你的终端中拥有对整个文件系统和命令行的完全访问权限。它的工作模式可以概括为你描述任务 → Claude 分析代码库 → Claude 规划执行方案 → Claude 执行你审批关键步骤核心区别在于不是「生成一段代码让你粘贴」而是「理解整个项目直接在多个文件上并行工作」。六大使用场景2026场景访问方式终端claudeCLI 命令VS Code扩展市场搜索 Claude CodeJetBrains插件市场安装桌面应用claude.com 下载Webclaude.ai/codeSlack团队管理员安装 Bot重要说明Web 版claude.ai/code和 Slack Bot 更多是交互界面或集成方式的扩展Claude Code 最强大、最原生的运行环境依然是终端。所有场景共享同一引擎——CLAUDE.md 配置、用户 Settings、MCP 服务器均可跨平台生效。二、安装与配置2.1 系统要求系统版本要求macOS10.15LinuxUbuntu 20.04WindowsWindows 10强烈推荐 WSL22.2 macOS / Linux 安装方式一一键安装脚本推荐curl -fsSL https://claude.ai/install.sh | bash # 验证安装 claude --version方式二HomebrewmacOSbrew install --cask claude-code方式三npm 全局安装跨平台通用npm install -g anthropic-ai/claude-code2.3 Windows 安装推荐方案WSL2Windows 用户强烈推荐使用 WSL2 安装以获得完整的 Unix 工具链兼容性部分高级功能如 Git Worktrees、MCP 服务器在原生 Windows 上可能存在边缘情况。# 在 WSL2 终端中执行 curl -fsSL https://claude.ai/install.sh | bash原生 Windows 方案不推荐# PowerShell irm https://claude.ai/install.ps1 | iex # 或使用 WinGet winget install Anthropic.ClaudeCode2.4 登录与认证安装完成后直接运行claude命令即可进入交互模式首次使用会自动触发登录流程。登录方式有三种方式适用场景Claude 个人账户个人开发需订阅 Pro/MaxAnthropic ConsoleCI/CD 自动化API 计费第三方 API 接入国内用户首选——通过环境变量接入第三方模型 API对于 WSL2 / SSH / 容器环境可以使用新增的认证命令claude auth login # 浏览器完成登录后将 OAuth 代码粘贴回终端即可遇到问题可以在交互模式中运行/doctor进行自动诊断。三、国内免费使用方案接入第三方模型 API3.1 核心思路Claude Code 本身是免费工具官方收费的是 Claude 官方模型的 API 调用。但 Claude Code 支持通过环境变量接入任意兼容 Anthropic API 格式的第三方模型服务这意味着你只需要为第三方模型的 API 调用付费甚至使用免费额度无需订阅 Claude Pro/Max。目前支持接入的国内主流模型包括模型提供商接入方式DeepSeek V3.1 / V4DeepSeekAPI 中转Qwen3-Coder阿里百炼API 中转GLM-4.5 / GLM-4.6智谱 AI官方 Anthropic 兼容接口Kimi K2月之暗面官方 Anthropic 兼容接口MiniMax M2MiniMaxAPI 中转3.2 配置方法Claude Code 通过读取~/.claude/settings.json文件中的环境变量来决定调用哪个模型 API 。基本配置格式{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的API_KEY, ANTHROPIC_MODEL: deepseek-reasoner, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-reasoner } }各模型的具体配置示例DeepSeek V3.1 { env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的DeepSeek API Key, ANTHROPIC_MODEL: deepseek-reasoner, ANTHROPIC_SMALL_FAST_MODEL: deepseek-reasoner } }智谱 GLM-4.5 { env: { ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, ANTHROPIC_AUTH_TOKEN: 你的智谱API Key } }注意智谱接口会自动根据任务复杂程度在 GLM-4.5 和 GLM-4.5-Air 之间路由无需显式指定模型 。阿里 Qwen3-Coder { env: { ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy, ANTHROPIC_AUTH_TOKEN: 你的百炼API Key, ANTHROPIC_MODEL: qwen3-coder-plus, ANTHROPIC_SMALL_FAST_MODEL: qwen3-coder-plus } }注意百炼接口当前仅支持qwen3-coder-plus模型 。Kimi K2 { env: { ANTHROPIC_BASE_URL: https://api.moonshot.cn/anthropic, ANTHROPIC_AUTH_TOKEN: 你的Moonshot API Key, ANTHROPIC_MODEL: kimi-k2-turbo-preview, ANTHROPIC_SMALL_FAST_MODEL: kimi-k2-turbo-preview } }3.3 NVIDIA 免费 API 方案NVIDIA 也提供免费 API 额度支持 minimax-m2、glm-4.7 等模型每分钟限制 40 次调用 。但 NVIDIA API 走的是 OpenAI 兼容协议与 Claude Code 原生格式不兼容需要通过代理工具如 CLIProxyAPI 或 CCR进行协议转换后才能使用 。四、CCSwitch模型接入的可视化管理工具4.1 什么是 CCSwitch手动编辑settings.json虽然可行但每次切换模型都需要修改配置文件并重启 Claude Code效率低下且容易出错。CCSwitch简称 CC Switch是一个开源跨平台桌面端配置管理工具核心作用是统一管理 AI 编程工具的模型配置实现 API 供应商的可视化一键切换。核心优势 功能说明 图形化管理无需手动编辑 JSON 配置文件 一键切换模型点击即可在不同模型服务商之间切换️ 预设模板内置 DeepSeek、智谱、Kimi、百炼、MiniMax 等 50 预设供应商 MCP 统一管理可视化添加、编辑、删除 MCP 服务器配置 连通性自检自动测试 API Key 有效性和网络连通性 安全存储所有 API Key 本地加密存储不会上传至外部服务4.2 支持的 AI 工具CCSwitch v3.16.3 完整支持 Claude Code、Claude 桌面客户端、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等七款主流 AI 编程工具 。4.3 安装与基本使用下载安装从 CCSwitch 官方渠道下载对应平台的安装包支持 Windows、macOS、Linux配置流程 安装 CCSwitch ↓ 启动并导入现有配置或新建 ↓ 点击右上角「」添加供应商 ↓ 选择预设模板如 DeepSeek、智谱等或自定义配置 ↓ 填写 API Key 和必要参数 ↓ 点击「Enable」激活该供应商 ↓ 启动 Claude Code自动使用当前激活的模型交互式 CLI 工具备选除了桌面版 CCSwitch还有基于命令行的bainiu/ccswitch支持npx零配置运行# 交互式模型选择和切换 npx bainiu/ccswitch # 列出已安装模型 npx bainiu/ccswitch model list # 添加新模型 npx bainiu/ccswitch model add支持内置模板包括 GLM、Kimi、DeepSeek、Qwen、MiniMax 等 。4.4 为什么推荐使用 CCSwitch降低配置门槛新手无需理解 JSON 配置结构图形界面引导完成配置提升切换效率在不同模型间切换只需点击按钮无需重启终端多工具统一管理一套配置同时管理 Claude Code、Codex、Gemini CLI 等多个工具避免配置错误预设模板自动填充正确的 Base URL 和通信协议减少手动输入错误五、核心命令速查5.1 启动模式命令说明claude进入交互模式claude 修复 src/app.ts 中的错误单次任务模式claude -p 解释认证流程Print 模式非交互直接输出到 stdoutclaude -c继续上次会话claude -r打开会话选择器claude --from-pr 42从 PR #42 恢复会话claude commit直接运行内置 commit skill5.2 会话内 Slash 命令命令作用/help显示所有可用命令/clear清除对话上下文/compact压缩上下文以节省 Token/cost查看 Token 用量和费用/model切换 AI 模型/hooks配置自动化 Hooks/skills查看可用 Skills支持搜索过滤/agents查看和管理 Sub-agents/resume恢复历史会话支持粘贴 PR URL/schedule创建定时 Routine/init为项目生成 CLAUDE.md/doctor自动诊断常见问题/pr-comments响应 PR Review 评论5.3 键盘快捷键快捷键功能?显示所有快捷键Tab命令 / 文件路径自动补全CtrlO切换扩展思考模式CtrlC取消当前操作Esc关闭 / 返回CtrlR全局命令历史搜索文件路径引用文件自动加载 CLAUDE.md5.4 权限确认机制当 Claude 需要执行敏感操作时会弹出确认提示Claude 想要运行: npm test 允许? [y]es / [n]o / [a]lways / [d]eny always选项含义y本次允许n拒绝Claude 尝试备选方案a本会话内始终允许该操作d永久拒绝该操作模式六、五大核心工作流工作流 1编写代码Claude Code 能处理从单个函数到全栈功能的任意规模任务# 简单函数 创建一个验证邮箱地址的工具函数处理边界情况包含 JSDoc 文档 # 多文件特性开发 1. 创建用户个人资料的数据库表 2. 创建获取和更新个人资料的 API 端点 3. 构建允许用户查看和编辑信息的网页 # 全栈功能数据库 后端 前端 构建完整的用户通知功能 1. 创建通知表id, user_id, type, title, message, read, created_at 2. 创建 NotificationServicecreate/markAsRead/getUnread/getAll 3. 添加 REST 端点GET /api/notifications, PATCH /api/notifications/:id/read 4. 构建 React 通知铃组件显示未读数量 下拉列表 5. 添加 WebSocket 支持实时显示新通知 6. 为 Service 层和 API 层写测试进阶技巧用引用参考文件让 Claude 遵循已有代码模式 按照 src/routes/users.ts 和 src/services/userService.ts 里的模式 为 products、categories、reviews 创建 CRUD 端点工作流 2理解代码库Claude Code 是极其强大的代码导航工具几秒钟就能解析整个项目结构 这个项目是干什么的 解释整体架构和关键设计决策 追踪用户点击提交订单到发送确认邮件的完整请求流程 找到所有处理用户认证的地方 解释 src/middleware/auth.ts 的每一行——处理了哪些边界情况可能出什么问题工作流 3修复 Bug贴入错误信息Claude 会自动定位并修复# 粘贴错误信息 运行 npm test 时看到这个错误 TypeError: Cannot read properties of undefined (reading map) at UserList (/src/components/UserList.tsx:15:23) # 自动运行并修复 运行 npm test找到失败的测试并修复 # 复杂问题排查 结账页面在手机上显示空白屏桌面端正常。 1. 检查结账组件里的响应式 CSS 和媒体查询 2. 查找可能依赖视口的 JavaScript 错误 3. 检查是否有第三方脚本阻止了手机渲染 4. 提出并应用修复方案工作流 4编写测试# 找出未覆盖的代码 找出 auth 模块里没有测试覆盖的函数 # 生成测试用例 为 src/services/payment.ts 编写全面的单元测试包含边界情况和错误场景 # TDD 流程 1. 为一个根据重量、距离、配送速度计算运费的函数写失败测试 2. 实现函数使测试通过 3. 为非法输入添加边界测试 # 覆盖率分析 分析 src/services/ 目录的测试覆盖率哪些函数没有测试 按风险排序建议优先补哪些测试工作流 5Git 与 Pull RequestClaude Code 深度集成了 Git 工作流# 智能提交 提交我的变更生成描述性的 commit 消息 # 创建 PR 创建一个 PR # 从 PR URL 恢复会话Week 18 新增 /resume # 在选择器里粘贴 PR URL自动跳到创建该 PR 的会话 # 响应 PR Review 评论 /pr-comments # Claude 读取 PR 上的审查评论逐一处理 # 代码审查 claude --from-pr 42 # 从 PR #42 的 Diff 开始会话进行审查七、CLAUDE.md项目配置的核心CLAUDE.md 是提升 Claude Code 输出质量最有效的单一手段。它会在每次会话开始时自动加载告诉 Claude 你的项目规范与约定。快速生成在项目根目录的交互模式中运行/initClaude 会扫描整个项目自动生成一份 CLAUDE.md 草稿你只需编辑调整即可。示例配置# 项目电商 API ## 技术栈 - Node.js 20 TypeScript 5.4 - Express.js Zod 验证 - PostgreSQL Prisma ORM ## 常用命令 - npm run dev — 启动开发服务器 - npm test — 运行测试 - npm run build — 生产构建 ## 代码规范 - API 响应统一格式{ data, error, meta } - 错误处理用 src/utils/errors.ts 里的 AppError 类 - 所有数据库查询通过 src/repositories/ 里的 Repository 模式 ## 架构说明 - src/routes/ — Express 路由处理器 - src/services/ — 业务逻辑 - src/repositories/ — 数据库访问最佳实践做法说明✅ 放 Claude 无法自己推断的内容如特定框架版本、内部约定❌ 避免泛泛而谈「这是 TypeScript 项目」没有价值✅ 具体而非泛泛「用 Prisma ORMSchema 在 prisma/schema.prisma」比「用 Prisma」好✅ 保持精简过长的 CLAUDE.md 会稀释重要规则的作用八、Hooks事件触发自动化Hooks 允许你在 Claude Code 发生特定事件时自动运行自定义脚本例如# macOS任务完成时弹出桌面通知 osascript -e display notification Claude Code 完成了 with title Claude Code # 播放提示音 afplay /System/Library/Sounds/Glass.aiff # Linux 桌面通知 notify-send Claude Code 任务完成Hooks 保存在用户级设置中跨会话和项目持久有效。九、Skills可复用工作流Skills 是按需加载的工作流模板本质是 Markdown 文件只在被调用时消耗 Token不占用日常会话的上下文。查看和调用# 查看可用 Skills支持搜索过滤 /skills # 直接调用内置 Skills claude commit # 暂存并提交 claude review # 审查当前变更创建自定义 Skill在项目下创建.claude/skills/deploy/SKILL.md--- name: deploy description: 部署到生产环境 disable-model-invocation: true allowed-tools: Bash(npm *) Bash(git *) --- 部署流程 1. 运行 npm test失败则停止 2. 运行 npm run build 3. 推送到 deploy/production 分支 4. 验证健康检查通过十、权限与安全权限配置.claude/settings.json{ permissions: { allow: [ Bash(npm test), Bash(npm run lint), Bash(git *) ], deny: [ Bash(rm -rf *) ] } }Auto Mode谨慎使用Auto Mode 会移除所有确认提示Claude 自主执行。仅推荐在以下场景使用隔离的容器或虚拟机没有生产凭证的沙箱环境有 Channels 监控和回滚机制的环境hard_denyWeek 19 新增即使在 Auto Mode 下也绝对拒绝的危险操作{ autoMode: { hard_deny: [ Bash(rm -rf /), Bash(curl * | bash) ] } }hard_deny规则无法被allow覆盖提供最高级别的安全保障。十一、成本优化建议策略说明精确 引用用src/services/auth.ts而非「看看认证相关代码」定期/compact长会话中压缩上下文以节省 Token任务拆分大任务拆成多个会话各自聚焦一个部分Print 模式-p一次性查询用 Print 模式不保留上下文模型选择探索性任务用轻量模型复杂任务用高性能模型查看消耗/cost随时监控 Token 使用情况使用国内模型普通任务使用国产模型高复杂度任务使用 Claude 官方接口十二、2026 年高级功能一览功能简介Routines云端定时 / API / GitHub 事件触发的自动化任务Dynamic Workflows数十到上百个并行 Sub-agents 协同处理超大任务Computer Use控制浏览器和 GUI 应用预览阶段Remote Control从任何地方连接和监控运行中的 SessionUltraplan在浏览器中规划传回终端执行UltrareviewAI 代码审查支持 CI 非交互调用后台子智能体自动在后台并行处理多项复杂任务2026 年 6 月底宣布将成为默认模式十三、总结Claude Code 代表了 AI 编程工具从「辅助补全」到「自主 Agent」的范式转变。它的核心优势在于终端原生直接访问文件系统和命令行无 IDE 限制多场景覆盖终端、IDE、桌面、Web、Slack 共享同一引擎项目级理解不只是单文件补全而是对整个代码库的深度理解安全可控精细的权限管理 Auto Mode hard_deny 三层安全体系高度可定制CLAUDE.md Hooks Skills 满足各种团队规范国内用户最佳实践对于国内开发者推荐以下使用路径安装 Claude Code通过 npm 或官方脚本安装获取第三方 API Key注册 DeepSeek、智谱、百炼或 Kimi 等平台获取 API Key使用 CCSwitch 管理配置通过可视化界面添加多个模型供应商一键切换按任务灵活选择模型普通任务用国产模型性价比高高复杂度任务用 Claude 官方接口效果好这种方案下你无需订阅 Claude Pro/Max只需为实际使用的 API 调用付费部分平台还提供免费额度大大降低了使用门槛。*本文信息整理自 Claude Code 官方文档及社区资料内容截止 2026 年 7 月。