OpenClaw LaunchOpenClaw Launch
← 首页

AI 编程工具

Claude Code 中文完整指南：Anthropic 命令行 AI 编程助手

Claude Code 是 Anthropic 推出的命令行 AI 编程工具，由 Claude Sonnet 4.6 / Opus 4.7 驱动，能在你的终端里读代码、改代码、跑测试、提交 PR。本文系统介绍 Claude Code 是什么、如何在 Mac/Windows/Linux 安装、常用命令、和 Cursor / Codex / Cline 的区别，以及如何通过 OpenClaw 把 Claude 的能力接入 Telegram、Discord、飞书。

Claude Code 是什么？

Claude Code 是 Anthropic 官方出品的命令行 AI 编程代理。它不是 IDE 插件，而是一个叫 claude 的 CLI 工具，背后是 Anthropic 的 Claude 4 系列模型（默认 Sonnet 4.6，可切到 Opus 4.7）。

一句话：Claude Code = Claude 驱动的终端版资深工程师。

进入项目目录敲 claude，它就能：

  • 读懂整个仓库的结构、依赖关系、惯用模式
  • 按自然语言指令重构代码、加功能、修 Bug
  • 调用 Shell 跑测试、运行构建、查看日志
  • 生成提交信息、创建 Pull Request
  • 使用 1M 上下文窗口处理大型代码库
  • 通过 Skills、Hooks、MCP 工具扩展能力

和 GitHub Copilot 那种"边打字边补全"的 IDE 插件不同，Claude Code 的定位是代理式编程（Agentic Coding） — 你给一个完整任务，它自己拆解、动手、验证，你最后审 diff。

Claude Code 官网和下载

Claude Code 的官方入口是 claude.com/claude-code。它本身是 npm 包，没有独立的桌面安装程序 — 所谓的"Claude Code 桌面版"通常指通过 Claude Desktop 应用集成 Claude Code 的体验，但 CLI 才是主入口。

中国大陆用户访问 Anthropic 官网可能需要解决网络问题，可以参考 国内访问 AI 服务的网络方案。

如何安装 Claude Code

第 1 步：安装 Node.js

Claude Code 通过 npm 分发，需要 Node.js 18 或更新版本。如果还没装：

# macOS（推荐 Homebrew）
brew install node

# Windows / Linux
# 访问 https://nodejs.org 下载长期支持版

第 2 步：全局安装 Claude Code

npm install -g @anthropic-ai/claude-code

安装完成后，可以用 claude --version 确认装好了。

第 3 步：登录 Anthropic 账号

第一次运行 claude，它会引导你浏览器登录。Claude Code 支持以下账号方式：

  • Claude Pro / Max 订阅（按月计费，包含 Claude Code 用量额度）
  • Anthropic API Key（按 token 计费，适合企业团队）
  • 第三方 OAuth（部分企业版支持 SSO）

对个人开发者，Pro 订阅（约 $20/月）通常最划算 — 不用关心 API 计费，包月用量足够每天写几小时代码。

第 4 步：在项目里使用

进入代码目录直接提问：

cd my-project
claude "帮我给 src/auth/login.ts 加单元测试"

Claude Code 会读相关文件、生成测试、运行 npm test 验证、把结果反馈给你。如果想跑非交互模式（适合脚本和 CI）：

claude -p "审查 src/api 目录的 SQL 注入风险，输出 Markdown 报告"

常用命令和快捷键

Claude Code 启动后，常用斜杠命令：

命令作用
/help查看所有可用命令
/model切换 Sonnet / Opus / Haiku
/clear清空当前会话上下文
/compact压缩上下文，节省 token
/cost查看本次会话花费
/init生成 CLAUDE.md 项目说明
/review对当前 PR 做代码审查
/agents查看可用的 Sub-agents
/mcp管理 MCP 服务器连接

常用键盘快捷键：

  • Esc — 中断当前操作
  • Esc 两次 — 跳到上一条消息编辑
  • Shift + Tab — 切换 Auto-Accept Edits 模式
  • Ctrl + R — 在历史命令中搜索
  • ! 前缀 — 把后面内容当成 shell 命令直接执行

CLAUDE.md：让 Claude Code 真懂你的项目

Claude Code 启动时会自动读取项目根目录的 CLAUDE.md 文件。这是它"知道项目规则"的关键 — 你在这里写下的约定（数据库连接、命名风格、禁止的操作、部署流程），Claude 在每次对话里都会遵守。

建议至少包含：

  • 项目用什么技术栈、什么版本
  • 常用命令（启动、测试、构建、部署）
  • 风格规则（不要做 X、永远先 Y）
  • 重要数据/服务的连接方式
  • 团队约定（commit 格式、分支策略）

用 /init 命令可以让 Claude 自动扫描项目并生成第一版 CLAUDE.md。

Claude Code vs Cursor vs Codex vs Cline

对比维度Claude CodeCursorCodex CLICline
背后公司AnthropicAnysphereOpenAI开源（社区）
形态CLI（IDE 扩展可选）独立 IDE（Fork VS Code）CLIVS Code 扩展
默认模型Claude Sonnet 4.6多模型可选GPT-5 系列用户自带 API Key
上下文长度1M token（Sonnet）取决于模型取决于模型取决于模型
Skills 生态官方 + 社区丰富Cursor Rules较新开源插件
Hooks支持（事件钩子）有限有限不支持
MCP 工具原生支持支持支持支持
付费Claude 订阅或 API独立订阅 $20/月ChatGPT 订阅API 计费
最适合代理式重活、长任务IDE 沉浸开发OpenAI 生态用户追求开源/自托管

选型建议：

  • 已经订阅 Claude Pro / Max，且经常要做"一句话改全仓库"的任务 → Claude Code
  • 更习惯 IDE 内联工作流、喜欢看到代码就在编辑器里展开 → Cursor
  • 已经付费 ChatGPT Plus / Pro，希望工具包含在订阅里 → Codex CLI（参见 Codex 中文指南）
  • 想要完全控制后端、自带 API Key、可审计代码 → Cline

很多团队会同时用两到三个：写大块新功能用 Claude Code，IDE 内补全用 Cursor 或 Copilot，跑 CI 校验用 Codex exec。

Claude Code 最佳使用场景

1. 全仓库重构

"把所有 axios 调用换成 fetch + AbortController" — Claude Code 会扫描所有相关文件、改完、跑测试、列出修改清单。1M 上下文让它能一次性看完中型代码库。

2. 长链路功能开发

"实现订单退款流程：API 端点 + DB 迁移 + 前端按钮 + 邮件通知" — 给一个中等复杂度需求，Claude Code 自己拆解为 8-12 步，逐步实现并验证。你去开会，回来审 PR。

3. 代码审查和安全审计

claude -p "审查 src/api 的安全风险" — 输出结构化 Markdown 报告，标出 SQL 注入、XSS、权限绕过等问题。当作 Code Review 第一轮，省下人工时间。

4. 写测试和文档

Claude 4 系列在写单元测试和 README 上特别擅长 — 能从代码反推使用场景，写出有边界情况覆盖的测试，比模板生成的"骨架测试"高出一档。

5. 调试线上故障

把日志和栈追踪贴给 Claude Code，它能把 stack 关联到代码、提出假设、加打印验证、给出修复 PR。比自己挨行翻代码快很多。

把 Claude Code 接入聊天平台（OpenClaw 玩法）

Claude Code 本身是本地 CLI，但很多团队希望团队成员能在 Telegram、Discord、飞书、微信 里"@ 一下就用 Claude"。OpenClaw Launch 提供两种思路：

方式一：直接用 Claude 模型（推荐）

在 OpenClaw 配置里选择 openrouter/anthropic/claude-sonnet-4.6 或 openrouter/anthropic/claude-opus-4.7 作为模型，开启 Shell MCP 工具和代码执行 Skill。本质上你就有了"Claude 4.6 + Telegram UI" — 团队任何人 @ 机器人都能用上 Claude 的代理能力。

方式二：Claude Code 作为后端 Skill

把 claude -p 包装成一个 Skill 注册给 OpenClaw — 当用户在飞书说"帮 my-repo 加个登录页"，OpenClaw 把任务转给本地一台跑 Claude Code 的机器执行，结果反馈回聊天。这种方式适合需要真正访问代码仓库的场景。

Claude Code 的优势和局限

优势

  • 1M 上下文 — 中型代码库一次塞进上下文，不用反复让 Claude "读这个文件再读那个"
  • Skills + Hooks 生态 — 可以定义事件钩子、自定义工作流，扩展性远超大多数同类产品
  • 原生 MCP 支持 — 接 Slack、Linear、Sentry、Postgres、浏览器等只是配置一行
  • Sub-agents — 可以并行派多个子代理处理不同子任务（适合大型重构）
  • 中文表现优秀 — Sonnet 4.6 / Opus 4.7 的中文理解和生成在全球第一梯队
  • 沙箱完善 — 默认询问 shell 执行权限，重要操作有清晰的批准/拒绝提示

局限

  • 需要 Anthropic 账号 — 国内访问需解决网络问题
  • Pro 订阅有用量额度 — 大型项目跑一天可能撞到 5 小时窗口限制，需要升级 Max 或 API
  • 不是 IDE — 喜欢看着光标在编辑器里跳的开发者会觉得 CLI 反馈方式太"远"
  • 偶尔过度修改 — 4.6 比之前版本谨慎很多，但仍偶尔会改你没要求改的地方，记得看 diff

常见问题（FAQ）

Claude Code 收费吗？

Claude Code 工具本身免费，但要用就需要 Anthropic Pro 订阅（约 $20/月）、Max 订阅（约 $100/月）或 API Key（按 token）。Pro 包含的额度对个人开发者通常够用。

Claude Code 支持中文吗？

完全支持。可以全程用中文提问，Claude 会用中文回答，但代码和提交信息会按项目惯例（一般是英文）保留。这是 Anthropic 官方在 4.6 版本特别加强的能力。

Claude Code 和 Claude Desktop 是一回事吗？

不是。Claude Desktop 是 Anthropic 出的桌面 App，主要是聊天界面（类似 ChatGPT 桌面版）；Claude Code 是开发者工具，跑在终端里。两者可以配合使用 — Desktop 做日常对话，Code 做编程任务。

Claude Code 会乱改我的文件吗？

默认会请求确认。每次写文件和跑 shell 命令都会显示要做什么并询问，你可以批准/拒绝。也可以开 Auto-Accept Edits 模式批准所有文件修改，但 shell 执行仍需确认 — 重要项目建议在 Git 分支上跑并审 diff。

怎么让团队共用 Claude Code？

三种方式：(1) 每人单独装 + 各自 Pro 订阅；(2) 团队买 Anthropic 的 Team 套餐共享额度；(3) 通过 OpenClaw Launch 部署一个接入 Claude Sonnet 4.6 的 AI 助手到 Telegram / Discord / 飞书 / 微信，团队成员 @ 机器人即用，无需每人配置。

Claude Code 能跑在 Windows 上吗？

可以，但官方推荐通过 WSL2（Windows 上的 Linux 子系统）运行体验最好。原生 PowerShell 也能用，但部分 shell 集成功能在 WSL 下更稳。

开始使用

想让团队在 Telegram / Discord / 飞书里 @ 一下就用 Claude Sonnet 4.6？访问 OpenClaw Launch，2 分钟部署一个接入 Claude 的 AI 助手，无需每人单独配置 Claude Code。

相关阅读：Codex 中文指南 · Codex vs Claude Code 对比 · 所有模型 · Skills 列表 · MCP 工具

2 分钟搭建团队 Claude AI 助手

用 Claude Sonnet 4.6 / Opus 4.7，部署到 Telegram/Discord/飞书/微信。$3/月起。

立即部署