claude安装、配置、使用备忘
1. 安装claude code
官方给出的安装方法是curl -fsSL https://claude.ai/install.sh | bash但是即使配置代理，也无法正常安装，报错如下
# curl -fsSL https://claude.ai/install.sh | bash
curl: (22) The requested URL returned error: 403
因此可以使用以下安装方式，以下安装方式是老的安装方式，也是上面install.sh本质做的事情
# 添加 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_20.x | bash -
# 安装 Node.js
dnf install -y python3
dnf install -y nodejs --disablerepo=* --enablerepo=nodesource-nodejs # 此处指定源是为了防止从其他网络源下载nodejs，因为其他源的版本可能太低不能使用
# 验证安装
node --version # 应显示 v20.x.x
npm --version
# 安装claude-code
npm install --verbose -g @anthropic-ai/claude-code --registry https://mirrors.cloud.tencent.com/npm/
2.配置使用deepseek模型
需要先配置其他模型，否则进入claude会卡在Checking connectivity...
# vim .bashrc # 编辑.bashrc，替换sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx为你的的deepseek的key
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
# source .bashrc # 生效
验证是否生效
# claude
╭─── Claude Code v2.1.169 ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ │ Tips for getting started │
│ Welcome back! │ Run /init to create a CLAUDE.md file with instructions for Claude │
│ │ ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── │
│ │ What's new │
│ │ Added `--safe-mode` flag (and `CLAUDE_CODE_SAFE_MODE`) to start Claude Code with all customizations (CLAUDE.md, plugins, skills, hoo… │
│ │ Added `/cd` command to move a session to a new working directory without breaking the prompt cache mid-session │
│ │ Added a `disableBundledSkills` setting and `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` environment variable to hide bundled skills, workflo… │
│ deepseek-v4-pro[1m] · API Usage Billing │ /release-notes for more │
│ ~/workspace/sigma-mgr │ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
▎ Opus 4.8 is now available! · /model to switch
❯ 你是什么模型
Thought for 8s (ctrl+o to expand)
● 我是 DeepSeek V4 Pro（1M 上下文窗口），由 Anthropic 的 Claude Code（CLI 工具）编排和调用。
✻ Crunched for 9s
3. Claude Code 帮助手册
基本用法
claude [选项] [命令] [提示词]
Claude Code 默认启动交互式会话。使用 -p/--print 以非交互模式输出结果。
全局选项
会话管理
-p, --print
输出响应后退出（适用于管道操作）。非交互模式下会跳过工作区信任对话框，仅在你信任的目录中使用。验证失败的设置文件在此模式下会被静默忽略。
-c, --continue
继续当前目录中最近的会话。
-r, --resume [值]
通过会话 ID 恢复会话，或打开交互式选择器（可附带搜索关键词）。
--fork-session
恢复时创建新的会话 ID，而非复用原始会话（与 --resume 或 --continue 配合使用）。
-n, --name <名称>
为当前会话设置显示名称（显示在提示框、/resume 选择器和终端标题中）。
--session-id <uuid>
为会话指定特定的会话 ID（必须是有效的 UUID）。
--no-session-persistence
禁用会话持久化——会话不会被保存到磁盘，也无法恢复（仅与 --print 配合使用）。
--from-pr [值]
通过 PR 编号/URL 恢复关联的会话，或打开交互式选择器（可附带搜索关键词）。
模型与 AI 配置
--model <模型>
指定当前会话使用的模型。可使用别名（如 sonnet 或 opus）或完整模型名（如 claude-opus-4-8）。
--agent <代理>
指定当前会话使用的代理，覆盖配置中的 agent 设置。
--agents <json>
通过 JSON 对象定义自定义代理。例如：'{"reviewer": {"description": "Reviews code", "prompt": "You are a code reviewer"}}'
--effort <级别>
指定当前会话的努力级别。可选值：low、medium、high、xhigh、max
--fallback-model <模型>
当默认模型过载或不可用时自动回退到指定模型。接受逗号分隔的列表以按顺序尝试。每个用户回合开始时重新尝试主模型（仅与 --print 配合使用）。
--max-budget-usd <金额>
API 调用的最大美元消费限额（仅与 --print 配合使用）。
--betas <betas...>
在 API 请求中包含 Beta 头部（仅限 API 密钥用户）。
系统提示与上下文
--system-prompt <提示词>
指定会话使用的系统提示词。
--append-system-prompt <提示词>
在默认系统提示词后追加内容。
--add-dir <目录...>
额外允许工具访问的目录。
--exclude-dynamic-system-prompt-sections
将每台机器相关的部分（cwd、环境信息、内存路径、git 状态）从系统提示词移至第一条用户消息中，提高跨用户提示缓存复用率。仅在使用默认系统提示词时生效。
工具与权限
--tools <工具...>
指定可用的内置工具列表。使用 "" 禁用所有工具，使用 "default" 使用所有工具，或指定工具名称，如 "Bash,Edit,Read"。
--allowedTools, --allowed-tools <工具...>
逗号或空格分隔的允许工具名称列表，如 "Bash(git *) Edit"。
--disallowedTools, --disallowed-tools <工具...>
逗号或空格分隔的禁用工具名称列表，如 "Bash(git *) Edit"。
--permission-mode <模式>
会话的权限模式。可选值：acceptEdits、auto、bypassPermissions、default、dontAsk、plan
--dangerously-skip-permissions
跳过所有权限检查。仅推荐在没有互联网访问的沙箱环境中使用。
--allow-dangerously-skip-permissions
允许跳过所有权限检查作为选项，但默认不启用。仅推荐在没有互联网访问的沙箱环境中使用。
输入输出格式
--input-format <格式>
输入格式（仅与 --print 配合使用）：text（默认）或 stream-json（实时流式输入）
--output-format <格式>
输出格式（仅与 --print 配合使用）：text（默认）、json（单个结果）或 stream-json（实时流式输出）
--json-schema <schema>
结构化输出验证的 JSON Schema。示例：
{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}
--include-partial-messages
实时流式输出中包含部分消息块（仅与 --print 和 --output-format=stream-json 配合使用）。
--include-hook-events
输出流中包含所有钩子生命周期事件（仅与 --output-format=stream-json 配合使用）。
--replay-user-messages
将 stdin 中的用户消息重新输出到 stdout 以进行确认（仅与 --input-format=stream-json 和 --output-format=stream-json 配合使用）。
--verbose
覆盖配置中的详细模式设置。
配置与设置
--settings <文件或json>
加载额外设置的 JSON 文件路径或 JSON 字符串。
--setting-sources <源>
逗号分隔的要加载的设置源列表：user、project、local
--mcp-config <配置...>
从 JSON 文件或字符串加载 MCP 服务器（空格分隔）。
--strict-mcp-config
仅使用 --mcp-config 中的 MCP 服务器，忽略所有其他 MCP 配置。
--plugin-dir <路径>
从目录或 .zip 文件加载插件，仅当前会话有效。可重复使用：--plugin-dir A --plugin-dir B.zip
--plugin-url <url>
从 URL 获取插件 .zip 文件，仅当前会话有效。可重复使用：--plugin-url A --plugin-url B
模式开关
--bare
最小模式：跳过钩子、LSP、插件同步、归属信息、自动内存、后台预取、密钥链读取和 CLAUDE.md 自动发现。设置 CLAUDE_CODE_SIMPLE=1。技能仍可通过 /skill-name 解析。需显式提供上下文。
--safe-mode
安全模式：禁用所有自定义项（CLAUDE.md、技能、插件、钩子、MCP 服务器、自定义命令和代理、输出样式、工作流、自定义主题、按键绑定等）启动。适用于排查配置损坏问题。设置 CLAUDE_CODE_SAFE_MODE=1。
--disable-slash-commands
禁用所有技能。
--ide
启动时自动连接到 IDE（当恰好有一个有效 IDE 可用时）。
--prompt-suggestions [值]
启用提示建议。在 print/SDK 模式下，每轮后发送 prompt_suggestion 消息预测下一个用户提示。
--brief
启用 SendUserMessage 工具，允许代理与用户通信。
--chrome
启用 Claude in Chrome 集成。
--no-chrome
禁用 Claude in Chrome 集成。
Worktree 与远程
-w, --worktree [名称]
为当前会话创建一个新的 git worktree（可选指定名称）。
--tmux
为 worktree 创建 tmux 会话（需要 --worktree）。当可用时使用 iTerm2 原生窗格；使用 --tmux=classic 使用传统 tmux。
--remote-control [名称]
启动启用了远程控制的交互式会话（可选命名）。
--remote-control-session-name-prefix <前缀>
自动生成的远程控制会话名称前缀（默认：主机名）。
调试
-d, --debug [过滤器]
启用调试模式，可附带可选的类别过滤（如 "api,hooks" 或 "!1p,!file"）。
--debug-file <路径>
将调试日志写入指定文件路径（隐式启用调试模式）。
--mcp-debug
[已弃用，请使用 --debug] 启用 MCP 调试模式（显示 MCP 服务器错误）。
-v, --version
输出版本号。
-h, --help
显示命令帮助。
文件资源
--file <文件信息...>
启动时下载的文件资源。格式：file_id:相对路径，如 --file file_abc:doc.txt file_def:img.png
子命令
claude agents — 管理后台代理
claude agents [选项]
--add-dir <目录>— 为派发会话额外允许工具访问的目录（可重复使用）--agent <代理>— 代理视图派发会话的默认代理，覆盖配置中的agent设置--all— 与--json配合使用：包含已完成的会话（完整的代理视图列表）--allow-dangerously-skip-permissions— 使跳过权限模式可用于派发会话，但默认不启用--cwd <路径>— 仅显示在指定路径下启动的后台会话--dangerously-skip-permissions—--permission-mode bypassPermissions的别名--effort <级别>— 代理视图派发会话的默认努力级别--json— 将会话列表以 JSON 数组形式输出并退出（用于脚本，不需要 TTY）--mcp-config <配置>— 应用于派发会话的 MCP 服务器配置（可重复使用）--model <模型>— 代理视图派发会话的默认模型--permission-mode <模式>— 代理视图派发会话的默认权限模式--plugin-dir <路径>— 为代理视图和派发会话从指定目录加载插件（可重复使用）--setting-sources <源>— 逗号分隔的要加载的设置源列表--settings <文件或json>— 应用于代理视图和派发会话的设置文件或 JSON 字符串--strict-mcp-config— 在派发会话中仅使用--mcp-config中的 MCP 服务器
claude auth — 管理认证
claude auth [选项] [命令]
子命令：
claude auth login [选项]— 登录你的 Anthropic 账户claude auth logout— 退出你的 Anthropic 账户claude auth status [选项]— 显示认证状态
claude mcp — 配置和管理 MCP 服务器
claude mcp [选项] [命令]
添加 MCP 服务器
claude mcp add <名称> <命令或URL> [参数...]
示例：
# 添加 HTTP 服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
# 添加带自定义头的 HTTP 服务器
claude mcp add --transport http corridor https://app.corridor.dev/api/mcp \
--header "Authorization: Bearer ..."
# 添加带环境变量的 stdio 服务器
claude mcp add my-server -e API_KEY=xxx -- npx my-mcp-server
# 添加带子进程标志的 stdio 服务器
claude mcp add my-server -- my-command --some-flag arg1
其他子命令
claude mcp add-from-claude-desktop— 从 Claude Desktop 导入 MCP 服务器（仅 Mac 和 WSL）claude mcp add-json <名称> <json>— 通过 JSON 字符串添加 MCP 服务器（stdio 或 SSE）claude mcp get <名称>— 获取指定 MCP 服务器的详细信息claude mcp list— 列出所有已配置的 MCP 服务器claude mcp remove [选项] <名称>— 移除一个 MCP 服务器claude mcp reset-project-choices— 重置当前项目中所有已批准/已拒绝的项目范围 MCP 服务器claude mcp serve [选项]— 启动 Claude Code MCP 服务器
claude plugin / claude plugins — 管理插件
claude plugin [选项] [命令]
子命令：
claude plugin details [选项] <名称>— 显示插件的组件清单和预计 token 消耗claude plugin disable [选项] [插件]— 禁用一个已启用的插件claude plugin enable [选项] <插件>— 启用一个已禁用的插件claude plugin init/new [选项] <名称>— 在~/.claude/skills/<名称>/下创建新插件claude plugin install/i [选项] <插件>— 从可用市场安装插件（使用插件@市场指定特定市场）claude plugin list [选项]— 列出已安装的插件claude plugin marketplace— 管理 Claude Code 市场claude plugin prune/autoremove [选项]— 移除不再需要的自动安装依赖claude plugin tag [选项] [路径]— 为插件发布创建 git 标签，验证 plugin.json 与市场条目一致claude plugin uninstall/remove [选项] <插件>— 卸载一个已安装的插件claude plugin update [选项] <插件>— 将插件更新到最新版本（需要重启以应用）claude plugin validate [选项] <路径>— 验证插件或市场清单文件
claude project — 管理项目状态
claude project [选项] [命令]
子命令：
claude project purge [选项] [路径]— 删除项目的所有 Claude Code 状态（会话记录、任务、文件历史、配置条目）
claude doctor — 健康检查
claude doctor [选项]
检查 Claude Code 自动更新器的健康状态。
⚠️ 工作区信任对话框会被跳过。仅在你信任的目录中使用此命令。
claude install — 安装原生构建
claude install [选项] [目标]
安装 Claude Code 原生构建。使用 [目标] 指定版本：stable、latest 或具体版本号。
--force— 即使已安装也强制安装
claude setup-token — 设置长期认证令牌
claude setup-token [选项]
设置长期有效的认证令牌（需要 Claude 订阅）。
claude update / claude upgrade — 检查更新
claude update [选项]
检查更新并在有可用更新时安装。
claude ultrareview — 云端多代理代码审查
claude ultrareview [选项] [目标]
对当前分支（或 PR 编号/基准分支）运行云端托管的多代理代码审查并打印结果。
--json— 打印原始 bugs.json 数据而非格式化的结果--timeout <分钟>— 等待审查完成的最大分钟数（默认：30）
claude auto-mode — 检查自动模式分类器配置
claude auto-mode [选项] [命令]
子命令：
claude auto-mode config— 以 JSON 打印有效的自动模式配置claude auto-mode critique [选项]— 获取 AI 对自定义自动模式规则的反馈claude auto-mode defaults— 以 JSON 打印默认的自动模式规则
会话内快捷命令
以下命令可在交互式会话中直接输入使用：
代码与审查
| 命令 | 说明 |
|------|------|
| /init | 初始化新的 CLAUDE.md 文件，包含代码库文档 |
| /review | 审查一个 Pull Request |
| /code-review | 审查当前 diff 中的正确性 bug 和效率改进 |
| /security-review | 对当前分支的待处理更改进行安全审查 |
| /simplify | 审查代码的复用、简化、效率改进并应用修复 |
| /verify | 运行应用验证代码更改是否按预期工作 |
| /run | 启动并驱动当前项目应用查看更改效果 |
| /ultrareview | 云端多代理代码审查 |
工具与配置
| 命令 | 说明 |
|------|------|
| /agents | 管理后台代理 |
| /auth | 管理认证 |
| /mcp | 配置和管理 MCP 服务器 |
| /plugin / /plugins | 管理 Claude Code 插件 |
| /project | 管理 Claude Code 项目状态 |
| /doctor | 检查 Claude Code 的健康状态 |
| /install | 安装 Claude Code 原生构建 |
| /setup-token | 设置长期认证令牌 |
| /update / /upgrade | 检查更新并安装 |
研究
| 命令 | 说明 |
|------|------|
| /deep-research | 深度研究——网络搜索、获取来源、验证声明、生成引用报告 |
| /claude-api | Claude API / Anthropic SDK 参考（模型、定价、参数等） |
配置与自定义
| 命令 | 说明 |
|------|------|
| /update-config | 通过 settings.json 配置 Claude Code 行为（钩子、权限、环境变量等） |
| /keybindings-help | 自定义键盘快捷键和按键绑定 |
| /fewer-permission-prompts | 扫描对话记录，添加权限允许列表以减少权限提示 |
| /auto-mode | 检查自动模式分类器配置 |
其他
| 命令 | 说明 |
|------|------|
| /loop | 在固定间隔上重复运行提示或命令 |
| /clear | 清除对话上下文 |
| /context | 显示当前上下文使用情况 |
| /config | 打开配置对话框 |
| /color | 更改会话颜色 |
| /help | 显示帮助信息 |
| /workflows | 查看正在运行的工作流 |
常用场景示例
非交互式使用（管道）
# 用提示词运行并退出
claude -p "这段代码有什么问题？" --allowedTools "Read Grep"
# JSON 输出
claude -p "列出所有函数" --output-format json
继续/恢复会话
# 继续最近的会话
claude -c
# 通过 ID 恢复
claude -r <session-id>
# 从 PR 恢复
claude --from-pr 123
指定模型
claude --model sonnet # 使用 Sonnet 模型
claude --model opus # 使用 Opus 模型
claude --model claude-opus-4-8 # 使用特定版本
Worktree 隔离
claude -w # 在新 worktree 中启动
claude -w --tmux # 带 tmux 的 worktree
MCP 服务器管理
# 添加 HTTP MCP 服务器
claude mcp add --transport http my-server https://example.com/mcp
# 列出所有 MCP 服务器
claude mcp list
# 获取服务器详情
claude mcp get my-server
插件管理
claude plugin install my-plugin # 安装插件
claude plugin list # 列出已安装插件
claude plugin init my-skill # 创建新插件