文章来源|MS08067 AI安全攻防小组

作者:Taoing

Claude Code 是一个智能编码工具,可以在终端中运行,通过自然语言命令交互帮助开发者快速完成代码生成、调试、重构等任务。

一、安装 Claude Code

步骤一:安装

前提条件:

  • 您需要安装 Node.js 18 或更新版本环境

  • Windows 用户还需安装 Git for Windows

进入命令行界面,安装 Claude Code

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

运行如下命令,查看安装结果,若显示版本号则表示安装成功

claude --version

注意:如果您在安装过程中遇到权限问题,请尝试使用 sudo(MacOS/Linux)或以管理员身份运行命令提示符(Windows)重新执行安装命令。 安装成功后,还需后续步骤,若您直接使用 claude 命令启动,可能由于网络或地区限制无法使用。

步骤二:配置

配置环境变量:

通过在 MacOSLinux 或 Windows 中使用以下一种方式设置环境变量:

注意:设置环境变量时,有些命令不会返回任何输出。这是正常的,只要没有报错即代表成功。

注意:选择以下适合您操作系统的一种方式进行配置即可。

手动配置

根据您的环境选择下面一种方式即可,配置后需新建命令行窗口生效

# 编辑或新增 Claude Code 配置文件 `~/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `api_key` 为您上一步获取到的 API Key
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "api_key",
        "ANTHROPIC_BASE_URL": "https://xxx.xxxxxx.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}
# 在 Cmd 中运行以下命令
# 注意替换里面的 `api_key` 为您上一步获取到的 API Key
setx ANTHROPIC_AUTH_TOKEN your_api_key
setx ANTHROPIC_BASE_URL https://xxx.xxxxxx.cn/api/anthropic
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1
# 在 PowerShell 中运行以下命令
# 注意替换里面的 `your_api_key` 为您上一步获取到的 API Key
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_api_key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://xxx.xxxxxx.cn/api/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

步骤三:使用Claude Code

配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code

若遇到「Do you want to use this API key」选择 Yes 即可

启动后选择信任 Claude Code 访问文件夹里的文件,如下:

完毕!现在就可以正常使用 Claude Code 进行开发了。

常见问题:

如何切换使用模型
Claude Code 内部模型环境变量与模型对应关系,默认配置如下:
ANTHROPIC_DEFAULT_OPUS_MODEL:
ANTHROPIC_DEFAULT_SONNET_MODEL:
ANTHROPIC_DEFAULT_HAIKU_MODEL:

如有调整诉求,可直接通过调整配置文件的方式(位于 ~/.claude/settings.json)来调整到其他模型


手工修改配置不生效

若您手动修改了 ~/.claude/settings.json 配置文件,但发现配置没有生效,参考如下排查。

  • 关闭所有 Claude Code 窗口,重新打开一个新的命令行窗口,再次运行 claude 启动。

  • 如果问题仍然存在,您可以尝试删除 ~/.claude/settings.json 文件,然后重新配置环境变量,Claude Code 会自动生成一个新的配置文件。

  • 确认配置文件的 JSON 格式是否正确,检查变量名称和不能少逗号或多逗号,可以使用在线 JSON 校验工具进行检查。

推荐的 Claude Code 版本

建议使用最新版本的 Claude Code,您可以通过以下命令检查当前版本和升级:

我们在 Claude Code 2.0.14 等版本验证 OK。

# 检查当前版本
claude --version

2.0.69 (Claude Code)

# 升级到最新版本
claude update

二、Claude Code IDE 插件

Claude Code 是一个智能编码工具,可以在终端中运行,也可以通过在 Vscode, Jetbrains 等 IDE 安装插件使用。


安装使用 IDE 插件:

Claude Code for VS Code 插件

Claude Code Vscode 插件支持在 Vscode 及基于 Vscode 的 IDE(如 Cursor、Trae 等)中使用。

打开 Vscode,进入扩展市场,搜索并安装「Claude Code」插件进行安装。

安装完成后,点击如下图中的右上角 Claude Code 图标,即进入 Claude Code 页面,等待几秒待其初始化完成后即可使用。

完毕!现在就可以在 IDE 中正常使用 Claude Code 进行开发了。

Claude Code for Jetbrains 插件

Claude Code Jetbrains 插件支持 Jetbrains 的系列 IDE 如 IntelliJ IDEA、PyCharm、WebStorm 等。

打开 Jetbrains IDE(如 IntelliJ IDEA、PyCharm 等),进入插件市场,搜索「Claude Code」插件并进行安装。

安装完成后,重启 IDE 即可使用 Claude Code 功能。

完毕!现在就可以在 IDE 中正常使用 Claude Code 进行开发了。

三、skills

Skills核心特性

Skills 通过模块化、可组合的能力封装,具备以下核心特性:

  • 模块化设计:每个skills都是独立的文件夹,包含完整的指令、脚本和资源,如文档skills

    • 动态加载:AI Agent 可根据任务需求按需加载相应skills

  • 专业化能力:每个skills专注于特定领域,提供深度的专业知识和操作能力

  • 人性化交互:模拟人类专业skills的学习和应用方式

  • 可扩展性:支持自定义skills开发,满足个性化和企业级需求

组成拆解

一个完整的 Skills 就是一个标准化的文件夹体系,每个skills由若干文件组成,用来描述功能、脚本和引用资料

my-skills/
├── skills.md (必需)
│   ├── YAML 前置元数据 (必需)
│   │   ├── name: (必需)
│   │   └── description: (必需)
│   └── Markdown 指令 (必需)
└── 捆绑资源 (可选)
    ├── scripts/          - 可执行代码 (Python/Bash等)
    ├── references/       - 参考文档
    └── assets/           - 输出文件 (模板、图标、字体等)
当然我们还可以进行封装引用的Tools(工具)、Knowledge(知识库)

Skills教程

claude-plugins-official:https://github.com/anthropics/claude-plugins-official

anthropics/skillsSkills技能市场:https://skillsmp.com/zh

专为中国用户优化的 AI Skills:https://skillhub.tencent.com/

Skills(技能),官方的解释是:使用 Skills 可以提升执行特定任务的能力。

Skills官方集合

智普

AI & 媒体处理技能

  1. VLM - 视觉语言模型:图像理解、图像分析

  2. TTS - 文本转语音:将文本转换为自然语音

  3. LLM - 大语言模型:对话、文本生成、聊天机器人

  4. ASR - 语音识别:语音转文字、音频转录

  5. Image-Generation - AI图像生成:从文本描述生成图像

  6. Video-Generation - AI视频生成:从文本或图像生成视频内容

通用技能

  1. Web-Search - 网络搜索:搜索和检索网络信息

  2. Web-Reader - 网页阅读:提取网页内容、抓取文章

文档与内容技能

  1. Docx - Word文档:创建、编辑Word文档

  2. Pptx - PowerPoint演示文稿:创建、编辑幻灯片

  3. Xlsx - Excel电子表格:创建、编辑数据表

  4. Pdf - PDF文档:创建、编辑PDF、填写表单

以上:openai-skills、智普skills 寻找客服获取。

小编力荐Skills

Agent Browser

专为AI Agent 设计的浏览器自动化CLI,力荐

安装:npx skills add vercel-labs/agent-browser

Ralph Loop

Ralph Loop是一种基于“永不放弃”理念的AI编程新技术

然后在Claude Code里跑这条命令安装插件:

/plugin install ralph-wiggum@anthropics

安装完之后可以用/plugin命令确认一下,你应该能在列表里看到Ralph插件

装完后你会得到三个命令:

/ralph-wiggum:ralph-loop用来启动一个Loop

/ralph-wiggum:cancel-ralph用来中止正在运行的Loop

/ralph-wiggum:help用来看帮助文档。

基本用法

Ralph Loop的命令结构长这样:

/ralph-wiggum:ralph-loop "<你的任务>" --completion-promise "DONE" --max-iterations 10

三个关键参数:任务描述是你要Claude干什么;completion-promise是完成标记,Claude输出这个词就算完成;max-iterations是最大迭代次数,防止无限循环。

跑一个简单的试试:

/ralph-wiggum:ralph-loop "创建一个Python邮箱校验函数。要处理各种边界情况,写5个测试用例。完成后输出DONE。" --completion-promise "DONE" --max-iterations 5

你会看到Claude开始工作,写完代码想退出,被拦住,继续审视自己的代码,补充遗漏的情况,再跑一遍测试,发现问题修复……直到真正做完。

关于完成标记:Claude要用特定格式输出才算完成——<promise>DONE</promise>。只要它没输出这个,Loop就会继续。

四、MCP

联网搜索 MCP使用示例

联网搜索 MCP Server 是一个基于模型上下文协议 (Model Context Protocol) 的搜索能力实现,为 Claude Code兼容 MCP 的客户端提供智谱的强大搜索能力,包括网络搜索、实时信息获取等功能。

手动配置编辑 Claude Code 的配置文件, 位于用户目录下 .claude.json 的 MCP 部分:

{
  "mcpServers": {
    "web-search-prime": {
      "type": "http",
      "url": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp",
      "headers": {
        "Authorization": "xxxx.xxxxxx"
      }
    }
  }
}

扫码进入AI交流群

—  关于我们  —

镇江刺掌信息科技有限公司成立于2020年,公司旗下MS08067安全实验室,专注于网络安全领域教育、培训、认证产品及服务提供商。近两年,线上培训人数近10万人次,培养网络安全人才近6000名。

公司被认定为国家高新技术企业、国家科技型中小企业、江苏省创新性中小企业、江苏省民营科技企业、江苏省软件企业。并荣获机械工业出版社“年度最佳合作伙伴”、电子工业出版社-博文视点“优秀合作伙伴”、镇江市企业发展服务中心优质合作伙伴、镇江市网络安全应急支撑服务单位等荣誉称号。

图片

如果喜欢我们









欢迎 在看丨留言丨分享至朋友圈 三连

图片

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐