Claude Code配置及使用

配置方法

命令行方式

打开Linux环境的控制台(如华为云开发者空间),新建任意控制台窗口,执行如下命令安装nodejs

curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash

安装后需要执行source ~/.bashrc,才能在当前控制台使用npm.或者也可以直接新建控制台.
执行如下命令安装claude-code

npm install -g @anthropic-ai/claude-code
执行source ~/.bashrc生效环境变量
创建目录 mkdir ~/.claude, 修改文件 vim ~/.claude/settings.json
或者创建目录 mkdir /mnt/workspace/.claude, 修改文件 vim /mnt/workspace/.claude/settings.local.json (避免华为云工作空间关机后Claude配置数据丢失,这样配置需要以/mnt/workspace/作为Claude工作目录)
添加如下内容(以硅基流动的模型为例),其中的Api Key需要填表蓝区引入外部AI编码工具账号申请.xlsx,等待公司统一申请
```
{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn/",
        "ANTHROPIC_API_KEY": "xxx",
        "ANTHROPIC_MODEL": "Pro/zai-org/GLM-4.7",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "Pro/zai-org/GLM-4.7",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "Pro/zai-org/GLM-4.7",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "Pro/zai-org/GLM-4.7",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}
```
修改~/.claude.json文件,在其中添加(否则在运行claude时会报错 Unable to connect to Anthropic services)
```
{
  "hasCompletedOnboarding": true
}
```
在控制台输入claude,能够进入交互界面,表示配置成功

图形界面方式

在VS Code Server(如华为与开发者空间)中的插件管理中搜索Claude Code for VS Code后安装

这个是Claude插件官方提供的Claude插件,安装后可以支持使用Claude Code的图形界面(需要Claude账号)和让Claude的中的操作与VS Code产生联动,比如显示将要修改的文件内容.

如果要将这个Claude插件触发打开的Claude交互界面修改为控制台交互(这种场景建议还是直接用VS Code自己的控制台,这个插件提供的控制台在开发者空间断连后再重连就会失效,普通控制台就没有这个问题),可以修改修改vscode的settings.json配置 (在vscode的管理->配置文件->设置中设置)

添加
```
"claudeCode.useTerminal": true,
```
注意这个插件使用的Claude是其自己下载维护的,其使用的配置也是独立的,如果使用图形界面交互则需要单独在vscode中配置claude.如果使用命令行界面交互则没有这个问题.
在VS Code Server(如华为与开发者空间)中的插件管理中搜索Claude Code and Codex Assist 或者 Claude Code Sessions 后安装

这个插件提供了Claude Code命令行交互历史查询及跳转能力,以及查看每个任务的详细修改内容,非常有用.

常见问题

在claude中让agent读取网页内容比如读取api文档时出现权限报错

在claude的工作目录下的中.claude/settings.local.json下添加(避免读取网页时访问claude.ai进行证书校验)
```
{
  "skipWebFetchPreflight": true
}
```

配置文件

claude全局配置

参考 https://code.claude.com/docs/zh-CN/settings#可用设置中的选项说明进行Claude配置

~/.claude/settings.json

注:claude的工作目录下也会生成.claude/settings.local.json文件,这个是只作用于当前工作目录的claude配置

用户偏好设置

此文件包含用户偏好（主题、通知设置、编辑器模式）、OAuth 会话、用户和本地作用域的 MCP server 配置、每个项目的状态（允许的工具、信任设置）和各种缓存。

~/.claude.json

系统提示

包含 Claude 在启动时加载的说明和上下文

~/.claude/CLAUDE.md

使用方式

基本操作

切换模式

通过claude按shift+tab切换模式

Ask 模式：只读分析
Ask 模式是 Claude Code 的默认安全模式。
- 使用场景:
  看不懂现有代码
  刚接手一个新项目
  想定位 Bug 的原因，但还没想好怎么修
  想确认某段逻辑是否合理
- 模式特点:
  Claude 可以读取代码
  可以进行分析、解释、推理
  绝对不会修改任何文件
  不会执行任何 Shell 命令
Plan 模式：只规划，不执行
Plan 模式是确定好方案后再执行。
- 使用场景:
  新增一个核心模块
  重构已有接口或业务流程
  引入新技术（缓存、中间件、鉴权方案等）
  涉及多个文件、多个层级的修改
- 模式特点:
  Claude 不会直接改代码
  会先给出完整的实施方案
  通常以步骤列表（TODO List）的形式呈现
  你确认方案后，才进入 Edit 阶段执行
Edit 模式: 分析后立即执行。
和AI Chat类似,问一句执行一句
- 使用场景
  已经明确知道：
  要改哪
  改成什么
  改动风险可控
  此时就可以直接进入 Edit 模式。
- 模式特点
  Claude 会定位相关文件
  生成精确的 Diff（差异修改）
  可能会请求执行测试、构建等命令
  所有写入操作都需要你确认

恢复交互

恢复上一次的交互

claude -c
恢复历史中的某一次交互
claude -r

显示当前执行命令的详细信息

ctrl+o

退出交互界面

连续输入两次ctrl + d

进阶操作

快速执行

cat 代码文件 | claude "优化这段代码"
git diff HEAD | claude "生成PR描述"

允许所有操作(高危操作)

claude --dangerously-skip-permissions

内置命令

命令	说明
`/add-dir`	添加额外的工作目录
`/agents`	管理专用 AI 子代理
`/bashes`	列出和管理后台任务
`/clear`	清除对话历史
`/compact [指令]`	压缩对话,可选择性添加重点指令
`/config`	打开设置界面(配置选项卡)
`/context`	以彩色网格可视化当前上下文使用情况
`/cost`	显示 token 使用统计
`/doctor`	检查 Claude Code 安装健康状况
`/exit`	退出 REPL
`/export [文件名]`	导出当前对话到文件或剪贴板
`/help`	获取使用帮助,显示所有可用命令
`/hooks`	管理工具事件的钩子配置
`/ide`	管理 IDE 集成并显示状态
`/init`	使用 CLAUDE.md 指南初始化项目
`/install-github-app`	为仓库设置 Claude GitHub Actions
`/mcp`	管理 MCP 服务器连接和 OAuth 认证
`/memory`	编辑 CLAUDE.md 记忆文件
`/model`	选择或更改 AI 模型
`/output-style [样式]`	直接设置输出样式或从选择菜单中选择
`/permissions`	查看或更新权限
`/plugin`	管理 Claude Code 插件
`/pr-comments`	查看 PR 评论
`/privacy-settings`	查看和更新隐私设置
`/release-notes`	查看发布说明
`/rename`	给这次会话重新起标题(默认为会话的第一条语句),建议每次手动起名,方便后续查找
`/resume`	恢复对话
`/review`	请求代码审查
`/rewind`	回退对话和/或代码
`/sandbox`	启用沙盒 bash 工具,具有文件系统和网络隔离
`/security-review`	对当前分支的待处理更改进行安全审查
`/status`	打开设置界面(状态选项卡),显示版本、模型、账户和连接状态
`/statusline`	设置 Claude Code 的状态行 UI
`/todos`	列出当前待办事项
`/vim`	进入 vim 模式,交替插入和命令模式

基本能力

系统工具

工具	描述	需要权限
Bash	在您的环境中执行 shell 命令	是
Edit	对特定文件进行有针对性的编辑	是
Glob	基于模式匹配查找文件	否
Grep	在文件内容中搜索模式	否
LS	列出文件和目录	否
MultiEdit	对单个文件原子性地执行多个编辑	是
NotebookEdit	修改 Jupyter notebook 单元格	是
NotebookRead	读取和显示 Jupyter notebook 内容	否
Read	读取文件内容	否
Task	运行子代理来处理复杂的多步骤任务	否
TodoWrite	创建和管理结构化任务列表	否
WebFetch	从指定 URL 获取内容	是
WebSearch	执行带有域过滤的网络搜索	是
Write	创建或覆盖文件	是

扩展能力

插件系统

Claude Code 插件系统可以扩展和定制开发体验，添加自定义命令、代理、Skills、Hooks 和 MCP 服务器。

目录定义

一个插件通常由这些组件构成

目录	用途
`.claude-plugin/`	包含 `plugin.json` 清单文件（必需）
`commands/`	自定义斜杠命令
`agents/`	自定义子代理
`skills/`	Agent Skills
`hooks/`	事件钩子配置
`.mcp.json`	MCP 服务器定义
`.lsp.json`	LSP 服务器配置

功能定义

command
自定义命令（/command）可以把高频提示模板、流程清单固化成可复用入口。
Skill
Skills 用来扩展 Claude Code 的能力：你创建一个 SKILL.md（以及可选的支持文件），Claude 就会把它当作“可复用的工具箱”。Skill 既可以被 Claude 在合适场景自动加载，也可以由你通过 /skill-name 手动调用。
SubAgent
Subagents（子代理）是专门处理特定类型任务的 AI 助手。每个 Subagent 在独立的上下文窗口中运行，拥有自定义系统提示、特定工具访问权限和独立权限设置。
MCP
MCP（Model Context Protocol）是 AI 工具集成的开放标准。通过 MCP 服务器，Claude Code 可以连接数据库、API、浏览器、外部工具等数百种数据源。
Hook
Hooks 允许在 Claude Code 特定事件发生时自动执行脚本或 LLM 评估，实现自动化工作流。

内置插件

https://github.com/anthropics/claude-code/tree/main/plugins

Skills,Sub-Agents,MCP间的差异

特性	Skills	Sub-Agents	MCP (Model Context Protocol)
目的	用专业知识、工作流程、资源扩展 Claude	生成自主代理处理复杂子任务	连接外部工具和数据源
调用方式	模型自动发现（基于上下文）	父代理显式生成	MCP 服务器工具调用
持久性	触发时加载到上下文	独立运行，返回结果	无状态工具执行
最适合	领域专业知识、工作流程、模板	并行任务、研究、探索	外部 API、数据库、第三方服务
上下文使用	渐进式披露（元数据→指令→资源）	每个子代理有独立上下文	最小上下文（仅工具定义）
复杂度	低（只需 SKILL.md + 可选文件）	中等（需要编排）	中-高（需要服务器设置）
示例	代码审查指南、部署工作流程	「研究这个主题」、「探索代码库」	GitHub API、数据库查询、Slack 集成

使用建议：

Skills：需要 Claude 遵循特定程序、使用领域知识或重复执行脚本时
Sub-Agents：需要并行工作、委托复杂研究或隔离任务时
MCP：需要与外部系统、API 交互时

posted @ 2026-02-12 11:51 JaydenChu 阅读(644) 评论(0) 收藏举报

刷新页面返回顶部