Anthropic 官方 AI 编程 Agent在终端里直接驾驭整个代码仓库 2026 年 4 月更新 | ⏱ 阅读约 8 分钟目录什么是 Claude Code环境准备安装 Claude Code登录与认证第一次使用核心命令速查VS Code 集成进阶技巧国内使用建议一、什么是 Claude CodeClaude Code 是 Anthropic 于 2025 年推出的Agent 级 AI 编程工具以命令行CLI为核心运行形态同时提供 VS Code 扩展。与 GitHub Copilot 等「代码补全」工具不同Claude Code 是真正的自主 Agent——它能读取整个代码库、执行 bash 命令、查看 git 历史、运行测试甚至独立完成跨文件的功能开发。核心能力能力说明 全仓库理解读取项目所有文件具备完整上下文生成的代码符合现有风格⚡ 自主执行任务无需人工逐步确认可规划多步骤任务并独立执行完成 工程级操作调用 bash 命令、安装依赖、运行测试、提交 git一条龙服务 CLAUDE.md 记忆通过配置文件持久化项目规范让 AI 始终遵循团队约定适用人群需要快速理解并修改大型代码库的开发者希望用自然语言驱动整个功能开发流程的工程师需要 AI 辅助 Code Review、重构、测试生成的团队二、环境准备安装 Claude Code 前需确认以下环境已就绪依赖项最低版本验证命令下载地址Node.jsv18推荐 v22node -vnodejs.orgnpm随 Node.js 附带npm -v—Gitv2.0建议git --versiongit-scm.comAnthropic 账号Claude Max / Pro 订阅—claude.ai# 检查 Node.js 版本node-v# 应输出 v18.x.x 或以上npm-v# 应输出 9.x.x 或以上⚠️Windows 用户注意Claude Code 基于 Unix 哲学设计Windows 原生环境兼容性有限。强烈建议先安装 WSL2开启方法以管理员身份运行 PowerShell执行wsl --install重启后继续。三、安装 Claude Code提供多种安装方式根据操作系统选择最适合的方案方式一官方安装脚本最新推荐# macOS / Linuxcurl-fsSLhttps://claude.ai/install.sh|sh# Windows PowerShell管理员运行irmhttps://claude.ai/install.ps1|iex方式二npm 全局安装# 安装 Claude Codenpminstall-ganthropic-ai/claude-code# 国内 npm 加速如遇到超时npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com# 验证安装claude--version方式三HomebrewmacOS 专属brewinstallclaude-code claude--version Homebrew 和 WinGet 安装的 Claude Code不支持自动更新需要手动执行brew upgrade claude-code升级。npm 安装版本支持自动后台更新下次启动生效。四、登录与认证安装完成后首次运行会引导你完成账号认证。Claude Code 支持以下登录方式步骤一启动 Claude Code在终端输入claude命令若是首次使用系统将自动进入登录流程。步骤二选择认证方式推荐选择Claude.ai 订阅账号登录需 Max 或 Pro 计划。也可使用Anthropic Console API Key按量计费。步骤三浏览器授权终端会自动打开浏览器跳转到 Claude 授权页面点击授权即完成绑定。Token 自动保存到本地~/.claude/下次无需重新登录。claude# 启动首次自动引导登录/login# 在交互模式内手动登录/logout# 退出当前账号使用 API Key 登录按量计费# macOS / Linux临时exportANTHROPIC_API_KEYsk-ant-xxxxxxxx# 永久写入追加到 ~/.zshrc 或 ~/.bashrcechoexport ANTHROPIC_API_KEYsk-ant-xxxxxxxx~/.zshrcsource~/.zshrc五、第一次使用进入项目目录运行 Claude Code# 进入你的项目目录cdmy-project# 启动 Claude Codeclaude# 让 AI 读取整个项目生成 CLAUDE.md 配置文件/init执行/init后Claude Code 会扫描整个项目将代码结构、依赖、命名规范等信息记录到CLAUDE.md文件中。此后每次启动都会自动加载该文件让 AI 始终了解你的项目背景。实战示例 1创建一个 REST API帮我创建一个 Express.js REST API包含用户注册、登录接口 使用 JWT 认证数据存储到 SQLite并生成对应的单元测试。Claude Code 会自动创建文件、安装依赖、编写代码并运行测试全程无需手动操作。实战示例 2修复 Bug运行 npm test找出所有失败的测试用例分析原因并修复。实战示例 3一键生成酒店管理系统构建一个酒店客户登记入住管理系统。 要求 - 终端输入客户信息姓名、性别、年龄、身份证号 - 数据保存在本地 SQLite - 注册和登录使用 Web 页面React - 提供完整的 CRUD API六、核心命令速查交互模式斜杠命令命令功能说明/init扫描项目生成/更新 CLAUDE.md 配置文件/help显示所有可用命令列表/config进入配置界面修改 Claude Code 设置/compact压缩历史对话减少 Token 消耗/clear清空当前对话上下文开始新任务/login重新登录或切换账号/logout退出当前账号登录/mcp查看 MCP 服务器连接状态/edit编辑用户记忆或项目记忆CLI 启动参数# 直接执行单次任务非交互模式claude-p创建一个 Python 快速排序函数# 继续上一次对话claude--continue# 跳过每步权限确认提升效率谨慎使用claude --dangerously-skip-permissions# 更新到最新版本claude update七、VS Code 集成步骤一安装扩展打开 VS Code → 扩展市场 → 搜索Claude Code→ 点击安装步骤二激活扩展安装完成后右上角会出现 Claude Code 图标点击进入侧边栏面板步骤三登录授权首次使用点击「Sign In」浏览器自动弹出授权页面完成绑定步骤四开始使用在侧边栏输入需求Claude Code 将感知当前打开的文件和项目结构提供精准的代码辅助ℹ️ VS Code 扩展版与 CLI 版本共享同一个 Agent 引擎功能完全等同。在 IDE 中使用的优势是能获得内联建议Inline Suggestions和一键差异查看Diff View更直观地审查 AI 的修改。八、进阶技巧① CLAUDE.md 项目配置最佳实践CLAUDE.md是 Claude Code 的项目说明书放在项目根目录每次启动时自动加载。一个好的 CLAUDE.md 应包含# 项目配置 ## 项目信息 - 项目名称电商平台 API - 技术栈Node.js Express PostgreSQL Redis - 开发环境Node 22.x, npm 10.x ## 编码规范 - ESLint Prettier 格式化 - 函数命名camelCase - 文件命名kebab-case - 提交信息Conventional Commits ## 常用命令 - 启动开发npm run dev - 运行测试npm test - 构建项目npm run build② Plan Mode 规划模式Plan Mode 下 Claude Code 只分析和规划不会实际修改代码适合在执行大型重构前先确认方案先分析整个项目架构提出重构方案暂时不要修改任何文件③ MCP 扩展集成# 添加 Brave 搜索 MCPclaude mcpaddsearch-suser-eBRAVE_API_KEYyour_key -- npx-ymodelcontextprotocol/server-brave-search# 查看已安装 MCP 服务claude mcp list# 在交互模式查看状态/mcp④ 减少 Token 消耗的技巧长对话告一段落后执行/compact压缩历史记录开始新任务前执行/clear清空上下文在 CLAUDE.md 中预置项目信息避免每次重复描述背景使用非交互模式claude -p ...执行单次简单任务九、国内使用建议⚠️ Anthropic 目前不对中国大陆地区提供直接服务国内用户访问 anthropic.com 和 claude.ai 需要科学上网。方案一切换到国内模型免费Claude Code 支持通过环境变量替换后端模型可以接入 DeepSeek、智谱 GLM 等国产模型exportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKEN${DEEPSEEK_API_KEY}exportANTHROPIC_MODELdeepseek-chatexportANTHROPIC_SMALL_FAST_MODELdeepseek-chatexportCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1方案二使用 cc-switch 可视化切换工具cc-switch 是一个开源的图形化桌面应用可以方便地在 Claude Code、Codex、Gemini CLI 等工具间切换后端模型配置避免手动编写环境变量。项目地址github.com/farion1231/cc-switch总结Claude Code 是目前最接近虚拟软件工程师的 AI 编程工具。它真正的价值在于理解整个代码库上下文的能力以及自主完成多步骤工程任务的能力。建议从中小型项目开始逐步熟悉其工作方式再应用到大型生产项目中。Claude Code 官方文档https://code.claude.com/docs/zh-CN/overview如有帮助欢迎点赞收藏 ⭐ 关注获取更多 AI 工具实战教程