Claude Code Doc

安装

第一步:安装 Claude Code

在终端中执行以下命令,全局安装 Claude Code:

bash 复制代码
npm install -g @anthropic-ai/claude-code

安装完成后,执行以下命令验证:

bash 复制代码
claude --version

第二步:配置环境变量

Claude Code 通过 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 确定服务地址与鉴权密钥。

Windows(以管理员身份打开 PowerShell):

powershell 复制代码
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://xxx.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 API Key", [System.EnvironmentVariableTarget]::User)

配置完成后,重启终端窗口使变量生效。

ANTHROPIC_AUTH_TOKEN 必须使用 Claude Code 专属分组的 API Key,不可使用其他客户端分组的密钥。

第三步:启动 Claude Code

bash 复制代码
claude       # 交互式会话
claude -p "问题"   # 非交互式,执行后退出

settings.local.json 常规设置

json 复制代码
{
  "permissions": {
    "allow": [
      "Bash(claude --version)",
      "Bash(claude --print)",
      "WebSearch",
      "Bash(claude settings *)",
      "Read(//c/Users/Administrator/.claude/**)",
      "WebFetch(domain:dev.to)",
      "Bash(npx tsc *)"
    ]
  }
}

安装位置(快捷键进入):%USERPROFILE%\.claude

Chrome DevTools MCP

bash 复制代码
claude mcp add chrome-devtools -s user -- npx chrome-devtools-mcp@latest

安装后可通过 MCP 工具操控浏览器、截图、性能追踪等。


命令

会话管理

命令 说明
/clear 清空对话历史
/compact 压缩对话历史但保留摘要
/resume 恢复之前的对话
/fork 将对话分支为新会话
/rename 重命名当前会话
/btw 快速插问,不打断正在执行的任务
/rewind 回退对话节点,代码文件一起恢复
/context 查看上下文窗口占用情况
/export 导出对话为纯文本文件
/diff 在交互式查看器中查看所有变更
/branch 分支管理

模型与输出

命令 说明
/model 在 Opus、Sonnet 和 Haiku 间切换
/fast 切换快速模式
/effort 交互式推理强度滑块(low / medium / high / xhigh / max)
/plan 切换计划模式(只读规划)
/theme 更改语法高亮主题
/output-style 更改输出样式
/voice 语音输入(针对编程词汇优化)
/focus 精简视图,仅显示最后提示 + 响应摘要

配置与设置

命令 说明
/config 打开设置面板(主题、模型偏好、语言等)
/permissions 管理工具权限
/keybindings 打开快捷键配置
/status-line 设置终端状态栏
/terminal-setup 设置 Shift+Enter 快捷键
/hooks 配置生命周期钩子
/init 新项目开局运行,生成 CLAUDE.md

子智能体与技能(v2.1.3 起斜杠命令与 Skills 统一)

命令 说明
/agents 创建和管理子智能体
/skills 技能管理菜单
/find-skills 浏览并安装技能
/powerup 动画教学,学习 context/hooks/MCP/subagents/loop

代码审查与安全

命令 说明
/review 审查 Pull Request
/pr-comments 显示当前分支的 PR 评论
/autofix-pr CI 失败或 Reviewer 评论时自动推送修复
/install-github-app 设置 GitHub PR 自动审阅
/security-review 对未提交变更进行安全审计

MCP 与插件

命令 说明
/mcp 管理 MCP 服务器连接
/plugin 进入插件市场,安装插件

后台与自动化

命令 说明
/tasks 查看后台任务
/loop 定时运行命令(可省略间隔,自调度)
/batch 跨 worktree 大规模并行重构

诊断与统计

命令 说明
/insights 生成使用分析报告
/usage 检查令牌使用量与套餐限额
/doctor 运行环境诊断
/debug 显示故障排查信息

其他

命令 说明
/team-onboarding 生成新成员上手指南(基于你的使用习惯)
/simplify 3 智能体审阅(架构、重复代码、性能)
/memory 编辑记忆文件
/sandbox 启用沙箱模式
/ide 管理 IDE 集成

账户

命令 说明
/login 重新身份验证
/logout 登出
/upgrade 升级套餐
/help 列出所有可用命令

全局命令 vs 项目命令

Claude Code v2.1.3 起,自定义斜杠命令与 Agent Skills 合并。可以将命令文件(.md)放置在不同位置来控制作用范围:

位置 作用范围 是否纳入版本控制
.claude/commands/*.md 当前项目
~/.claude/commands/*.md 全局(所有项目)

全局命令示例 --- 创建 ~/.claude/commands/review.md

markdown 复制代码
分析文件 $ARGUMENTS,指出:

1. 潜在 bug
2. 性能问题
3. 改进建议

然后在任意项目中使用:/review src/auth.ts

优先级:项目级命令覆盖全局同名命令。

你也可以在 ~/.claude/CLAUDE.md 中写入个人指令,它会在每个会话中自动加载。

CLI 命令

命令 说明
claude 启动交互式会话
claude "问题" 启动时附带初始提示
claude -p "问题" 非交互式模式,执行后退出
claude -c 恢复最近会话
claude -r "ID" 按 ID 恢复会话
claude --from-pr 恢复与 PR 关联的会话
claude update 更新到最新版本
claude auth login 身份验证
claude auth status 检查认证状态
claude auth logout 登出
claude agents 列出已配置的智能体
claude rc 启动远程控制会话
claude plugin 插件管理(CLI 方式)
claude config list 显示所有设置
claude config set 更新设置项
claude mcp add 添加 MCP 服务器
claude mcp list 列出 MCP 服务器
claude mcp remove 移除 MCP 服务器
claude mcp serve 将 Claude Code 作为 MCP 服务器运行
claude ultrareview [PR/分支] 云端多智能体代码审查

CLI 启动参数

参数 说明
--model opus 启动时指定模型
--effort high 设置推理深度(low/medium/high/xhigh/max)
--agents '{json}' 启动时定义子智能体
--append-system 追加系统提示词
--max-turns N 设置会话轮次上限
--dangerously-skip 跳过权限提示(危险)
--worktree 隔离 Git 工作树
--bare 最小模式:跳过 hooks/LSP/自动记忆等
--output-format json 输出格式(text/json/stream-json)
--settings <file> 加载额外设置文件
--mcp-config <file> 加载 MCP 配置文件
相关推荐
丹宇码农2 小时前
把 HLS 字幕玩出花:zwPlayer 如何让 M3U8 视频支持全文搜索、翻译与码率自适应
前端·javascript·音视频·hls·视频播放器
2501_943782352 小时前
【共创季稿事节】猜数字游戏:二分法思维与交互式反馈
前端·游戏·microsoft·harmonyos·鸿蒙·鸿蒙系统
GV191rLvq3 小时前
基于Socket实现的最简单的Web服务器【ASP.NET原理分析】
服务器·前端·asp.net
吠品3 小时前
LangChain 里 tool_call_id 为空?一次 MCP 工具集成的排查记录
前端
微信开发api-视频号协议3 小时前
企业微信二次开发中的文件系统设计:媒体资源、临时文件与业务附件
前端·微信·企业微信·媒体·ipad·微信开放平台
柒和远方3 小时前
Phase 7.4 学习博客:为什么多 API 项目需要 Swagger / OpenAPI
前端·后端·架构
张龙6873 小时前
拼多多开放平台对接踩坑实录:从 CLIENT_ID 配置到 MD5 签名算法的完整填坑指南
前端
GuWenyue3 小时前
提示词彻底过时?一套上下文工程方案,3步让LLM落地生产,代码直接复用
前端·javascript·人工智能
柒和远方3 小时前
Phase 7.3 复盘:后台任务不只是“扔进队列”,还要能被看见
前端·后端·架构