ACORG docs

主题

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(推荐 22.x LTS)
  • Git
  • 一个可登录的 Anthropic 账号(Pro / Team / Enterprise / API Key)
  • Windows 用户建议使用 Git Bash 或 WSL2 作为终端

安装 ​

bash
npm install -g @anthropic-ai/claude-code
bash
pnpm add -g @anthropic-ai/claude-code
bash
yarn global add @anthropic-ai/claude-code

验证安装:

bash
claude --version

首次登录 ​

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

bash
claude

首次启动会引导浏览器完成 OAuth 登录;若使用 API Key,可直接设置环境变量:

bash
# Windows PowerShell
setx ANTHROPIC_API_KEY "sk-ant-xxxx"

# Git Bash / WSL
export ANTHROPIC_API_KEY="sk-ant-xxxx"

常用命令 ​

命令作用
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 每次启动会自动加载:

markdown
# 项目说明
本仓库使用 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

参考链接 ​