企业官网建设流程全解析

简介：一文搞定 Claude Code 安装、跳过新手引导（附截图）、终端命令、可直接复制的编程 Prompt，同时说明报错Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST（无法连接官方的服务），新增 Claude Code 对接 Mimo 大模型settings.json配置、完整操作流程、Mimo 三参数（baseUrl/apiKey/model）获取方法；新增【Skill 工作手册】，并且配套 Skill 目录文件夹，里面存放多场景独立 Skill 文件；系统讲解提示词工程五大原则，重点拆解新手高频踩坑的否定陷阱（粉色大象问题），附带.claude.md项目规则、思维导图、提示词自检清单，帮你写出稳定可控、少幻觉的指令。

前言

最近在转型 AI 全栈开发，大量使用 Claude Code 做 Vibe Coding、项目重构、接口开发、Bug 排查。很多小伙伴刚上手会遇到一个致命问题： 首次执行claude进入会话，会触发新手 onboarding 引导阶段，这个阶段 Claude Code 会检测 IP；由于 Claude Code 屏蔽国内 IP，直接卡在引导环节，抛出报错：Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST，翻译：无法连接官方的服务。

同时很多同学希望脱离 Anthropic 官方接口，使用国内大模型（Mimo）来驱动 Claude Code 的 Agent 能力。本文会完整给出对接 Mimo 大模型的配置方案，以及去哪里拿到对接必须的baseUrl、apiKey、model三个参数。 另外，日常做 Vibe Coding、AI 智能体开发，我们会维护一套 Skill 集合，放在独立文件夹中，不同场景加载不同 Skill，而不是全部写在一个文档里，方便管理、按需启用。

本文把安装、跳过新手引导方案、IP 检测报错说明、Mimo 参数获取 + Mimo 对接配置、Skill 文件夹设计 + Skill 工作手册、常用命令、实战 Prompt、提示词工程方法论、否定陷阱一次性整理出来，附赠可直接放入项目的.claude.md、思维导图、提示词自检清单，适合后端、前端、Java/Python 开发者直接复用。

说明：Claude Code 是 Anthropic 官方推出的终端原生 AI 编程 Agent，原生支持 OpenAI 兼容接口转发，所以可以对接 Mimo 这类兼容 OpenAI 协议的大模型，保留它的文件读写、执行命令、项目感知的全部 Agent 能力，只是后端模型换成 Mimo。

一、Claude Code 安装（Windows / Mac / Linux）

前置说明：推荐官方一键脚本，不需要提前装 Node.js，稳定、自动更新。

1）MacOS / Linux / WSL

打开终端执行：

curl -fsSL https://claude.ai/install.sh | bash

2）Windows（PowerShell，管理员身份运行）

irm https://claude.ai/install.ps1 | iex

3）验证是否安装成功

claude --version

输出版本号即安装成功。

4）登录认证

⚠️ 如果你打算对接 Mimo 转发接口，不需要走官方claude login，直接用配置文件指定自定义后端！

# 仅使用Anthropic官方接口才需要执行登录 claude login

执行后会输出链接，浏览器打开登录 Anthropic 账号，复制授权码回到终端粘贴，完成认证。

5）补充安装方式（npm 全局，备选）

如果你习惯 npm 管理：

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

Mac 权限报错前面加sudo；Windows 建议管理员终端。

6）卸载命令

# Mac/Linux claude uninstall # npm方式卸载 npm uninstall -g @anthropic-ai/claude-code

✅ 常见安装 & 启动坑

1. Windows 报错执行策略受限：PowerShell 管理员执行Set-ExecutionPolicy RemoteSigned
2. 登录提示权限不足：确认账号有 Claude Code 访问权限
3. 连接报错：Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

原因：Claude Code 屏蔽国内 IP，新手引导阶段会主动发起网络请求检测 IP，国内环境直接报错阻断引导流程。解决办法：优先跳过新手引导，或者直接切换 Mimo 兼容接口。

✅ 首次启动跳过新手引导（onboarding）

⚠️ 重点：新手引导阶段就会联网校验地区 / IP，Claude Code 不对国内地区开放，走到这一步直接拦截报错，无法继续。所以千万不要直接运行 claude，要先提前创建配置文件跳过引导！

原理：Claude Code 通过用户家目录下的.claude.json里面hasCompletedOnboarding布尔标记，判断是否展示新手引导；标记为 true，直接跳过整套引导，不再触发引导阶段的地区 IP 检测，直达对话输入框。

📂 配置文件位置（全局，放在用户根目录，不是项目文件夹！）

• Mac / Linux / WSL：~/.claude.json，完整路径示例/Users/xxx/.claude.json
• Windows：C:\Users\你的用户名\.claude.json，等价于%USERPROFILE%\.claude.json

🔍 怎么查找这个配置文件

1. Mac/Linux/WSL 终端查看是否存在：

ls ~/.claude.json # 打开编辑 nano ~/.claude.json

1. Windows PowerShell 查看：

Test-Path $env:USERPROFILE\.claude.json # 直接用记事本打开 notepad $env:USERPROFILE\.claude.json

重点：默认安装后这个文件是不存在的，需要我们手动新建写入内容，再执行 claude。

✍️ 一键写入配置、跳过引导命令

Mac / Linux / WSL

echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

Windows PowerShell

echo '{\"hasCompletedOnboarding\": true}' | Out-File $env:USERPROFILE\.claude.json -Encoding utf8

✅ 操作顺序（非常关键，顺序错依旧会报错）：

1. 安装好 Claude Code
2. 先执行上面命令创建配置文件
3. 再打开终端输入claude

执行完成后，不会触发新手引导、不会触发引导阶段 IP 检测，直接进入对话输入界面。

二、Claude Code 对接 Mimo 大模型（OpenAI 兼容接口）

✅ 前置条件：Mimo 提供了OpenAI 兼容格式的接口地址、模型名称、API KeyClaude Code 原生支持自定义 OpenAI 兼容后端，通过settings.json配置文件切换模型，不用走 Anthropic 官方、不用魔法，直接走 Mimo 接口驱动 Claude Code 全部 Agent 能力

📌 如何获取 Mimo 的 baseUrl、apiKey、model 三个参数

1. 登录 Mimo 官方平台后台
2. 找到【API 开发 / 密钥管理 / 开放接口】菜单
3. 获取 apiKey：在 API 密钥页面，点击新建密钥，生成一串密钥字符串，复制保存。⚠️ 密钥只显示一次，记得妥善保管，不要直接公开到博客、代码里。密钥泄露会被别人消耗额度。
4. 获取 baseUrl：在接口文档里找到 OpenAI 兼容接口地址，结尾必须带上/v1，例如https://api.mimo.example.com/v1，直接复制这个地址作为 baseUrl。
5. 获取 model 模型标识：在模型列表 / 接口文档中，找到支持 OpenAI 协议、支持工具调用的模型标识名称，比如mimo-code、mimo-code-pro；优先选择代码专用版本。

提示：如果文档里有多个模型，一定要复制平台原始 model 名称，不能自己随便起名，名字错了会直接 404。 补充：如果是私有化部署的 Mimo，baseUrl 是你内网部署的服务地址，同样遵循/v1后缀规范。

小结：对接三要素

• apiKey：密钥管理页面生成
• baseUrl：OpenAI 兼容接口地址（带/v1）
• model：平台给出的模型标识符

📌 settings.json 文件存放路径（全局配置）

• Windows：%APPDATA%/Claude Code/settings.json
• Mac：~/Library/Application Support/Claude Code/settings.json
• Linux：~/.config/Claude Code/settings.json

💡 快速打开路径（Windows PowerShell）

# 直接打开文件夹 explorer "$env:APPDATA\Claude Code\"

如果文件夹、settings.json 不存在，手动新建文件夹，再新建settings.json

📄 settings.json 完整配置模板（对接 Mimo，直接复制）

{ "customOpenAICompatible": { "enabled": true, "baseUrl": "https://你的mimo接口地址/v1", "apiKey": "mimo-xxxx你的Mimo API Key", "model": "mimo模型标识", "headers": {} }, "defaultModel": "custom-openai-compatible" }

参数说明

1. enabled：开启自定义兼容接口，固定为true
2. baseUrl：Mimo 的接口地址，结尾必须带上/v1，OpenAI 协议规范
3. apiKey：你的 Mimo 平台密钥
4. model：Mimo 给你的模型名，例如mimo-code，以平台文档为准
5. defaultModel：固定填写custom-openai-compatible，代表默认使用自定义后端

✅ 完整操作步骤

1. 先完成前面【跳过新手引导】配置（.claude.json）
2. 登录 Mimo 后台拿到baseUrl、apiKey、model
3. 找到上面的Claude Code配置目录，新建 / 编辑settings.json，粘贴上面模板，替换三个参数
4. 关闭所有已经打开的 claude 终端会话（必须重启才会加载新 settings）
5. 新开终端，直接输入claude启动
6. 进入会话后输入/model，查看当前模型，确认已经切换为custom-openai-compatible

🧪 验证是否成功走 Mimo 接口

进入 claude 会话，发送一句测试指令：

输出一句话：当前后端模型是Mimo

正常返回说明对接成功；如果报错，优先检查：

• baseUrl 是否带/v1
• API Key 是否正确、账号余额充足
• model 名称和平台文档完全一致，不能写错
• Mimo 接口是否支持 stream 流式输出（Claude Code 依赖流式）
• 网络可以连通 Mimo 接口地址

⚠️ 重要限制 & 注意事项

1. Mimo 接口必须完全兼容 OpenAI Chat Completions 协议，不兼容的转发会直接报错
2. 切换到自定义 OpenAI 兼容后端之后，不再走 Anthropic 官方服务，不需要 claude login 登录
3. Claude Code 的 Agent 能力（读文件、执行命令、修改代码）全部保留，只是推理大模型换成 Mimo
4. 想切回官方 Anthropic 模型：修改 settings.json，把enabled设置为 false，重启 claude
5. 部分 Mimo 上下文窗口长度、工具调用能力会影响 Claude Code 的长项目解析效果，优先选择代码增强版本的 Mimo 模型
6. apiKey 不要提交到 Git、不要公开，建议本地环境变量方式使用，避免泄露

📌 临时切换（不修改 settings.json，环境变量方式）

不想写配置文件，可以启动前设置环境变量（Windows PowerShell 示例）

$env:CLAUDE_CODE_OPENAI_COMPAT_BASE_URL="https://你的mimo接口地址/v1" $env:CLAUDE_CODE_OPENAI_COMPAT_API_KEY="mimo-xxxkey" $env:CLAUDE_CODE_OPENAI_COMPAT_MODEL="mimo模型标识" claude

环境变量优先级高于 settings.json，关闭终端失效，适合临时测试、不想硬编码密钥的场景

三、Skill 体系：独立文件夹管理 + 基础 Skill 工作手册

设计思路：不再把所有规则堆在单一文件，项目根目录新建./skills/文件夹，按场景拆分多个独立 skill 文件，按需加载。基础通用规则放在skills/base-skill.md（也就是下面这份基础 Skill 工作手册），专项能力单独一个文件。 目录结构参考：

全局安装：✅C:\Users\bleach_ww\.claude\skills，这个路径对 Claude Code 非常舒服

优点：

1. 和 Claude 的配置目录放在一起，统一管理，不用到处找
2. 属于你的用户目录，权限一般不会踩坑，不用管理员权限
3. .claude本身就是 Claude Code 的标准家目录，生态上很顺

单独项目安装：C:\your-project\skills

your-project/ ├── .claude.md # Claude Code 全局默认加载规则（轻量） ├── skill.md # 快捷入口，引导读取skills目录 └── skills/ ├── base-skill.md # 【基础核心Skill，必选】通用编程Agent基线（下方内容） ├── skill-code-review.md # 代码审查专项Skill ├── skill-refactor.md # 代码重构专项Skill ├── skill-api-doc.md # 接口文档生成专项Skill ├── skill-sql.md # SQL数据库开发专项Skill └── skill-fix-bug.md # Bug排查修复专项Skill

使用方式：

1. 新开会话加载全套基础：读取 skills/base-skill.md，严格遵循本手册执行任务
2. 叠加专项能力：同时读取 skills/skill-code-review.md，执行代码审查
3. 你可以按需新增、删除 skills 下的文件，不同项目维护不同 skill 集合，方便跨项目复用

📄 skills/base-skill.md（基础 Skill 工作手册，必加载）

# Base Skill｜编程智能体基础工作手册 ## 0. 核心定位 你是项目专属编程智能体，目标：高效、安全、可控地完成开发任务。 优先保障代码正确性、业务不变、风险可控；不追求花哨实现，拒绝无理由重构。 ## 1. 思考流程（强制顺序） 收到需求后，固定按下面顺序思考，禁止跳过： 1）理解需求：确认目标、交付物、验收标准；需求模糊直接提问，不脑补 2）读取上下文：阅读相关源码、配置、文档、现有项目规范、其他加载的skill 3）方案设计：给出1套主方案，复杂场景可附带备选方案，说明优缺点 4）改动评估：梳理影响范围、风险点、依赖、是否需要改库/数据库 5）输出改动清单：【文件路径 + 修改目的】 6）编码实现：对齐项目原有代码风格 7）自检：语法、边界、异常、兼容性、是否引入新依赖 8）交付：代码 + 验证步骤 + 测试方式 ## 2. 编码规范 1）新增代码风格、命名、注释、分层和当前项目保持一致 2）优先复用已有工具类、全局异常、统一返回、常量，不要重复造轮子 3）所有外部参数必须做校验；接口增加入参校验 4）SQL相关避免直接拼接，优先参数化；涉及数据库变更必须高亮风险 5）新增依赖前先告知用户，等待确认，禁止私自引入第三方包 6）不删除原有注释、业务逻辑；注释只做补充，不要覆盖原有业务说明 ## 3. 工具调用&文件操作规则（Claude Code重点） 1）读文件优先，修改文件前必须先阅读原文件完整逻辑 2）批量修改多文件时，分批次输出，一次性改动文件不适合超大范围重构 3）执行shell命令前说明命令作用，高危命令（rm、drop、重启服务）必须征得确认 4）不主动扫描、修改项目以外目录文件 5）文件修改完成，简单说明改动验证方式 ## 4. 输出格式规范 1）方案说明使用普通文本；代码使用markdown代码块，标注语言 2）改动清单用列表/表格；报错分析分步输出 3）长内容适当分段，重点风险使用⚠️标记 4）回答精简，不闲聊，不输出无关鸡汤、无关示例代码 5）需要用户确认的内容单独列出【待确认】 ## 5. 边界与红线（硬约束，不可突破） 1）不编造不存在接口、类、函数、数据表、配置 2）不擅自修改核心业务逻辑，需求没有要求时，只做增强，不改原有逻辑 3）不输出可直接泄露密钥、密码、token的代码 4）遇到超出能力、不确定业务、风险极高的需求，直接告知，不强行尝试 5）禁止为了“优化”而大面积重构稳定运行的模块，重构必须用户明确指令 ## 6. 提示词约束规则（规避否定陷阱） 1）优先正向描述，尽量少堆叠“不要、禁止、别”这类否定词 2）如果存在否定约束，必须搭配正向目标一起说明，不能只有黑名单 3）自检Prompt，发现大量否定指令，主动转换成正向表达，并且告知用户 ## 7. 异常处理规则 1）代码运行报错：先定位根因，区分代码bug、环境问题、依赖缺失 2）接口对接报错：按顺序排查地址、密钥、模型名称、协议、网络 3）遇到Mimo接口/OpenAI兼容接口报错：优先输出排查清单（baseUrl、apiKey、model、流式支持） 4）无法定位时，列出排查步骤，而不是直接给出猜测性修复 ## 8. 收尾交付标准 交付结果必须包含至少： - 改动清单 - 核心代码 - 本地验证步骤 - 风险提示（如有）

补充示例：skills/skill-code-review.md（专项 skill 示例）

# Skill｜CodeReview 代码审查专项规则 1. 审查维度：正确性、边界异常、性能、安全、可读性、规范 2. 区分P0阻断bug / P1优化建议 / P2风格建议 3. 每条问题给出：位置、问题描述、修复方案、参考代码 4. 不做无意义的风格吹毛求疵，优先抓功能、安全、稳定性问题 5. 输出使用表格汇总问题，最后给出总结

使用小贴士：

• 每次新开 Claude 会话，可以直接发指令：先读取 skills/base-skill.md，再读取 skills/skill-code-review.md，严格按照加载的Skill执行本次开发任务
• 如果希望永久生效，可以把 base-skill 核心内容合并进.claude.md
• 对接 Mimo 模型时，整套 skills 规则同样生效，用来约束 Mimo 的输出行为

四、Claude Code 高频常用命令（斜杠命令 + 启动参数）

进入交互会话只需要输入：claude，进入之后可以使用内置斜杠命令：

表格

💡 补充：对接 Mimo 后，/cost无法读取 Anthropic 计费，这个是正常现象。

外部启动参数（直接在终端执行，不用进入会话）

# 直接传入任务，进入交互 claude "帮我重构这个FastAPI项目，拆分路由" # 一次性执行指令，执行完直接退出（适合脚本调用） claude -p "解释main.py里面的全局异常捕获逻辑"

小技巧：在项目根目录执行 claude，它会自动读取.git、目录结构、源码，理解整个项目。

五、配套：.claude.md 项目规则文件【直接复制放到项目根目录】

.claude.md放在项目根目录，Claude Code 启动会自动读取这份规则，相当于项目永久全局 Prompt，不用每次对话重复写约束，大幅减少乱改代码、幻觉、新增无关功能问题。对接 Mimo 模型时，这份规则同样生效，强烈建议配置。

# Claude Code 项目全局规则 ## 1. 角色定位 你是本项目专属开发助手，严谨、保守，优先保证代码可运行、业务逻辑不变，拒绝过度设计。 ## 2. 基础行为规范 - 修改代码前，先阅读相关文件，理解原有逻辑； - 改动前先输出【改动清单】：文件路径 + 修改原因； - 只修改本次任务相关代码，不主动重构无关模块； - 新增代码风格对齐项目现有代码，保持统一； - 如果信息不足，主动列出需要我提供的文件/信息，禁止编造不存在函数、变量、文件。 ## 3. 输出规范（正向要求，规避否定陷阱） - 代码优先使用标准markdown代码块，标注语言； - 复杂改动：先说明方案，再贴代码，最后给出验证方式； - 接口相关输出：入参、出参、异常返回清晰； - 回答精简，重点前置，不要无意义闲聊； - 涉及SQL时，说明是否加索引、是否存在慢查询风险。 ## 4. 项目边界（正向描述优先） - 新增依赖前，先告知我，等待确认再引入； - 改动数据库相关代码，必须提醒风险； - 测试代码按需补充，没有要求时不自动新增大量测试用例； - 遇到无法确定的业务规则，直接提问，不要自行假设业务。 ## 5. 兜底约束（少量兜底，不堆砌否定词） 仅在越界场景停止操作，遇到重大风险第一时间告知我。

使用方式：新建文件命名.claude.md，放到项目根目录，之后每次在这个项目里打开 claude 都会自动加载。

六、可直接复制的 Claude Code 编程 Prompt 模板

下面几个是我日常开发高频使用的 Prompt 模板，适配各类开发场景，直接丢给 Claude Code 即可使用，对接 Mimo 模型同样适用。

模板 1：代码审查 + Bug 定位 Prompt

你是资深后端工程师，现在对当前项目做代码审查。 1. 先梳理模块职责，找出潜在bug、空指针、异常未捕获、资源泄漏； 2. 区分严重bug、优化建议、代码规范问题； 3. 给出可直接替换的修复方案； 4. 输出用markdown表格，不要编造不存在的文件； 5. 如果信息不足，列出需要我补充的文件路径。

模板 2：项目重构 Prompt（Vibe Coding 首选）

你是项目架构师，帮我重构当前模块，遵守下面规则： - 不改动原有业务逻辑，保证兼容； - 单一职责原则，拆分大函数； - 增加注释、参数校验、统一异常处理； - 修改完成后，列出改动清单，并且给出简单测试用例； - 只修改相关文件，不要新增无关功能。

模板 3：生成接口文档 + 注释 Prompt

基于当前代码，生成标准接口文档： - 使用OpenAPI风格； - 标注入参、出参、错误码； - 给所有类和方法添加符合项目规范的注释； - 文档单独输出在一个markdown块。

模板 4：排查编译 / 运行报错

下面是报错堆栈，请定位根因，不要随意猜测。 先查看对应源码，分析报错链路，给出修复方案，同时说明为什么会出现这个问题。

七、提示词工程 Prompt Engineering：五大核心原则

提示词工程不是玄学，核心是降低模型的不确定性，给明确目标、约束、格式、角色、参考。我整理了最实用的五大原则，所有 Prompt 都可以套用：

原则 1：角色先行，先定义身份（Role）

先告诉模型它是谁、站在什么视角工作，而不是直接甩任务。 ❌ 差：帮我写代码 ✅ 好：你是 8 年后端 Java 架构师，熟悉 SpringBoot，代码追求可维护性，拒绝过度设计。

原则 2：明确目标，给出交付物（Goal）

清晰说明你想要输出什么成果，不要模糊描述。 ❌ 差：帮我优化一下这个接口 ✅ 好：帮我优化这个查询接口，目标：降低数据库慢查询，响应时间压缩到 200ms 以内，输出优化后的 SQL 和方案。

原则 3：补充上下文与背景（Context）

大模型不会读心术，缺少上下文就会脑补、幻觉。 需要主动提供：项目技术栈、现有框架、历史需求、约束条件、版本信息。

例：上下文补充：项目使用 FastAPI + Pydantic v2，数据库是 MySQL 8.0，已有全局异常处理器。

原则 4：指定输出格式（Format）

格式指令是性价比最高的约束，直接控制返回结构：表格、JSON、markdown、分步列表。

很多人 Prompt 无效，就是没有加格式要求，AI 自由发挥。

原则 5：约束边界，划定能做 / 不能做（Constraints）

这里重点提醒：优先正向约束，慎用大量否定约束，也就是我们下面要说的否定陷阱。

一句话总结五大原则：角色 + 目标 + 上下文 + 输出格式 + 约束边界，一个标准 Prompt 就成型了。

八、重点避坑：大模型的否定陷阱（粉色大象 Pink Elephant Problem）

这是新手踩坑最多的地方，也是提示词工程里面最重要的一个知识点。

什么是否定陷阱？

经典例子：不要去想一只粉色的大象。 你读完这句话，脑子里第一反应就是粉色大象。 大模型同理：它想要理解 “不要做 X”，必须先在注意力中激活 X 这个概念，否定词不要/禁止/别权重很低，反而 X 关键词被强化，最后更容易输出你禁止的内容。

学术上叫讽刺过程理论（Ironic Process Theory），在 LLM 里普遍存在，不是模型 bug，是注意力机制特性。

反面案例对比（强烈建议收藏）

❌ 负面指令（踩坑版）

不要写有bug的代码，不要幻觉，不要增加额外功能，不要啰嗦。

问题：反复提到 bug、幻觉、额外功能这些词，模型更容易跑偏。

✅ 正向改写（推荐版）

代码保证可运行，所有逻辑基于当前项目已有代码；只完成本次需求；回答精简，只输出必要内容。

再看一组： ❌：不要写太长，不要用复杂术语 ✅：回答控制在 300 字以内，使用入门开发者易懂语言

🧪 场景对比测试 ❌ 踩坑 Prompt：

修改这个接口，不要抛出未捕获异常，不要新增表，不要修改user表。

✅ 正向 Prompt：

修改这个接口，所有异常统一包装为项目标准返回；只在现有表上实现需求，操作范围限定在order表。

什么时候才可以少量使用否定？

不是完全不能写 “不要”，满足下面条件才适合：

1. 正向描述成本极高；
2. 否定项是边界兜底，同时搭配明确正向目标；
3. 否定数量少，不要一堆不要、禁止罗列。

黄金规则：优先告诉模型你想要什么，而不是反复告诉模型不要什么。 用白名单思维，而不是黑名单思维。

否定陷阱带来的典型现象

• 你说：不要随便新增文件 → AI 反而新建一堆无关文件
• 你说：不要改动用户表 → AI 还是修改 user 相关逻辑
• 你说：不要编造不存在的方法 → AI 依旧幻觉函数

根源：你反复强调的禁止内容，被模型重点关注了。

九、配套 1：精简思维导图（Markdown 脑图，可直接复制到 ProcessOn / 幕布）

预览

查看代码

豆包

你的 AI 助手，助力每日工作学习

## **Claude Code + Prompt工程 + Mimo对接 + Skill文件夹体系** - Claude Code使用 - 安装：一键脚本 / npm - 跳过新手引导：.claude.json标记、引导阶段检测国内IP，必须优先跳过 - 对接Mimo：settings.json自定义OpenAI兼容接口 - 获取Mimo参数：baseUrl、apiKey、model - Skill体系：skills文件夹，拆分base+多个专项skill - 常见报错：Unable to connect to Anthropic services（屏蔽国内IP） - 常用命令：/compact /clear /cost /model - 项目规则：.claude.md（自动加载） - Prompt工程五大原则 - 角色Role - 目标Goal - 上下文Context - 输出格式Format - 约束Constraints - 避坑：否定陷阱（粉色大象） - 原理：先激活禁止内容 - 方案：正向描述优先 - 否定仅做兜底，少量使用 - 写Prompt流程 - 角色→目标→上下文→正向要求→格式→兜底约束→验收标准 - 实战 - 可直接复制Prompt模板 - 辅助工具 - 提示词自检清单

十、配套 2：提示词自检清单 ✅【每次写 Prompt 对照检查】

写好 Prompt 之后，一条一条对照，提前规避幻觉、跑偏、否定陷阱问题，适合 Claude Code 编程场景专用，Mimo 模型同样适用

• ✅ 角色是否定义清晰？告诉模型是谁、能力定位
• ✅ 最终交付目标是否明确？知道要产出什么
• ✅ 补充项目上下文：技术栈、框架、版本、已有限制
• ✅ 指定输出格式（代码块 / 表格 /json/markdown）
• ✅ 约束优先正向描述（写 “要怎么做”，而不是一堆不要）
• ✅ 是否大量堆砌 “不要、禁止、别”？如果是，改成正向表达
• ✅ 信息不足时，是否要求模型主动提问，而不是自行脑补
• ✅ 有没有验收标准，怎么判断结果合格
• ⚠️ 兜底否定不超过 2 条，只用于极端风险拦截

使用技巧：可以把这份自检清单加到你的.claude.md末尾，或者本地笔记里。

十一、怎么写出稳定好用的指令？一套落地流程

结合五大原则 + 否定陷阱 + Skill 文件夹体系，我固定这套流程写 Prompt：

1. 角色：你是谁，风格是什么；
2. 任务目标：最终交付物；
3. 上下文：项目、技术栈、已有限制；
4. 正向要求：应该怎么做；
5. 输出格式：表格 / 分步；
6. 兜底约束（少量否定，仅用来兜底）；
7. 验收标准：怎么判断合格。

示例完整结构：

【角色】你是熟练的FastAPI后端开发，注重代码简洁，拒绝冗余。 【目标】给这个接口增加参数校验和全局异常捕获。 【上下文】项目使用pydantic v2，已经有全局异常处理器，不能引入新第三方包。 【正向要求】校验失败返回统一错误JSON，错误码规范。 【输出格式】先说明改动方案，再输出改动内容。 【兜底约束】不要重构其他无关接口。

十二、总结

1. Claude Code 优先官方一键脚本安装；
2. ⚠️核心重点：Claude Code 屏蔽国内 IP，新手引导阶段会联网检测 IP，国内环境直接报错，必须先新建.claude.json写入hasCompletedOnboarding: true，再执行 claude；
3. 报错Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST= 触发 IP 拦截；
4. ✅ 国内替代方案：登录 Mimo 后台拿到baseUrl、apiKey、model，通过settings.json配置自定义 OpenAI 兼容后端对接 Mimo，保留全部 Agent 能力；
5. ✅推荐使用skills/文件夹管理整套 Skill，基础基线 + 独立专项 Skill 文件，按需加载、便于维护和跨项目复用；
6. 记住核心斜杠命令/compact /clear /cost，长会话一定要压缩上下文；对接 Mimo 后 /cost 计费统计失效；
7. .claude.md是神器，全局固化项目规范，省去重复说明；
8. 标准 Prompt 框架：角色 + 目标 + 上下文 + 格式 + 约束；
9. 提示词工程五大原则是骨架，而否定陷阱是最容易忽略的隐形大坑；
10. 写 Prompt 之前用自检清单校验，正向描述优先；
11. 用好 Claude Code + Mimo + skills 目录 + 高质量 Prompt，Vibe Coding 效率会提升一大截，但依然要坚持人工审核 AI 改动，避免隐性 Bug。

后续我会持续更新更多专项 Skill 文件、Claude Agent 高级配置、多文件协同开发 Prompt。如果本文对你有帮助，欢迎点赞收藏，评论区交流踩坑经历后续我会持续更新 Claude Agent 高级配置、多文件协同开发 Prompt。如果本文对你有帮助，欢迎点赞收藏，评论区交流踩坑经历！