Claude Code

Anthropic 官方推出的命令行 AI 编程助手,在终端中直接调用 Claude 模型完成代码读写、重构、调试与多文件协同任务。

作用说明

Claude Code 是一个运行在终端中的 Agent,具备以下能力:

• 直接读写本地代码、运行 Shell 命令、执行测试
• 跨多个文件理解项目结构,完成重构、Bug 修复、新特性开发
• 支持 MCP(Model Context Protocol),可挂接 JetBrains、Playwright、数据库等外部能力
• 支持 Skill、Subagent、Hooks 等机制,可深度定制工作流
• 可在 CLI、桌面端、Web 端(claude.ai/code)、IDE 插件中使用

适用人群:希望让 AI 接管"读代码 → 改代码 → 验证"完整闭环的开发者。

环境要求

• Node.js ≥ 18。若通过 npm 安装,建议使用当前 LTS；官方原生安装方式不要求你单独管理 Node.js。
• Git
• 一个可登录的 Anthropic 账号(Pro / Team / Enterprise / API Key)
• Windows 用户可直接使用 PowerShell 安装和运行；需要 Linux 工具链时再使用 WSL2。

安装

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows WinGet

winget install Anthropic.ClaudeCode

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash

Homebrew

brew install --cask claude-code

官方当前推荐使用原生安装器或 Homebrew。npm 安装已标记为 deprecated，不再作为默认安装方式；如果所在环境只能使用 npm，请先查看官方 setup 文档确认兼容性。

验证安装:

claude --version

Windows PowerShell 还可以确认命令实际来自哪里:

Get-Command claude

首次登录

进入任意项目目录后执行:

claude

首次启动会引导浏览器完成 OAuth 登录。若使用 API Key,只需选择自己使用的终端执行对应示例:

Windows PowerShell

$env:ANTHROPIC_API_KEY = "sk-ant-xxxx"

macOS / Linux / WSL

export ANTHROPIC_API_KEY="sk-ant-xxxx"

以上只在当前终端生效。若要让 Windows 新开的终端也能读取,可使用用户级环境变量配置,但当前终端不会自动刷新。不要将真实密钥写入仓库；OAuth 登录通常比手动管理 API Key 更简单。

常用命令

命令	作用
claude	在当前目录启动交互式会话
claude -c	继续上一次会话(continue)
claude -r	选择一个历史会话恢复(resume)
claude -p "..."	非交互一次性执行(print 模式)
/help	会话内查看所有可用斜杠命令
/clear	清空当前上下文,但保留工作目录
/init	为当前项目生成 CLAUDE.md 记忆文件
/config	打开配置面板,切换模型 / 主题等
/mcp	查看已加载的 MCP 服务及工具列表

基本工作流

1. cd 到项目根目录

2. 运行 claude,首次建议先执行 /init 让它了解项目

3. 用自然语言描述需求,例如:

   把 src/utils/date.ts 里的格式化函数迁移到使用 dayjs,并补充单测

4. Claude 会列出计划、读写文件、运行命令,关键操作会请求确认

5. 完成后可让其 /review 自检,或直接 git diff 查看改动

推荐配置

在项目根目录创建 CLAUDE.md,写入项目背景、编码规范、构建命令等,Claude 每次启动会自动加载:

# 项目说明
本仓库使用 Vue3 + Vite + TypeScript,组件库使用 Ant Design Vue。

# 构建与测试
- 启动: `pnpm dev`
- 构建: `pnpm build`
- 测试: `pnpm test`

# 约定
- 不要在组件中直接写 axios 调用,统一走 src/api/*
- 提交前必须通过 ESLint

常见问题

• 登录后仍报未授权:检查代理 / 网络,确认能访问 api.anthropic.com
• Windows 路径报错:使用 Git Bash 终端,或在路径中统一使用正斜杠
• 想接入 JetBrains:参考 IDEA MCP 接入
• 多账号切换:参考 CC Switch

参考链接

• 官方文档: https://docs.claude.com/en/docs/claude-code
• 反馈仓库: https://github.com/anthropics/claude-code/issues