在终端里，让 Claude 理解、修改并运行你的项目。
安装 Anthropic 官方 Claude Code，通过 OmniDino Anthropic Messages 网关连接 Claude 模型，在真实代码库中完成开发、调试、测试、Git 工作流、MCP 扩展和自动化任务。
Claude Code 不是普通聊天机器人。
它可以读取整个代码库、跨文件修改内容、运行命令，并围绕开发目标持续工作。
你描述目标，Claude Code 负责探索、规划和执行。
它可以解释项目结构、追踪错误根因、实现功能、编写测试、修复失败并处理 Git 工作流。因为它具备文件和命令工具权限，正式使用前应先设置清晰的项目规则与权限边界。
所有下载工具均引用 GitHub 项目。
Anthropic Claude Code
Anthropic 官方 Claude Code 仓库，提供安装说明、插件、示例和问题反馈入口。
CC Switch
跨平台开源配置管理器，可为 Claude Code 保存 OmniDino Base URL、API Key 和模型参数。
Git
Claude Code 在真实仓库中处理 Diff、分支、提交和回滚时需要 Git。
Visual Studio Code
可选的开源编辑器，用于查看文件、Diff、终端和 Claude Code 修改结果。
选择与你的终端匹配的命令。
Windows PowerShell
使用 Anthropic 官方 PowerShell 安装脚本。
claude --version。irm https://claude.ai/install.ps1 | iex
claude --versionWindows CMD
CMD 与 PowerShell 使用不同命令，不要混用。
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
claude --versionmacOS、Linux 或 WSL
使用 Anthropic 官方 Shell 安装脚本。
claude。curl -fsSL https://claude.ai/install.sh | bash
claude --versionHomebrew
macOS 和支持 Homebrew 的 Linux 环境可使用 Cask 安装。
brew install --cask claude-code
# 后续升级
brew upgrade claude-codeWindows WinGet
通过 Windows 包管理器安装 Claude Code。
winget install Anthropic.ClaudeCode
# 后续升级
winget upgrade Anthropic.ClaudeCodeClaude Code 使用 Messages 网关。
OmniDino Key 通过 Bearer Token 发送，因此推荐使用 ANTHROPIC_AUTH_TOKEN。
OmniDino 参数
Claude Code 会在 Base URL 后调用 Anthropic Messages 相关路径，因此这里填写根地址，不要额外添加 /v1。
x-api-key，才改用 ANTHROPIC_API_KEY。OmniDino 常规 Bearer Key 推荐使用 ANTHROPIC_AUTH_TOKEN。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.omnidino.com",
"ANTHROPIC_AUTH_TOKEN": "粘贴你的OmniDino API Key",
"ANTHROPIC_MODEL": "填写实际Claude模型名称"
}
}.claude/settings.json。请使用用户级 ~/.claude/settings.json，或使用会话环境变量。Windows 对应路径是 %USERPROFILE%\.claude\settings.json。
export ANTHROPIC_BASE_URL="https://api.omnidino.com"
export ANTHROPIC_AUTH_TOKEN="粘贴你的OmniDino API Key"
export ANTHROPIC_MODEL="填写实际Claude模型名称"
claude先看 /status，再开始真实任务。
Claude Code 内检查
从设置环境变量的同一个终端启动 Claude Code。
/status 中应看到 OmniDino 的 Anthropic Base URL，以及 ANTHROPIC_AUTH_TOKEN 作为认证来源。
请只读取当前项目的 README 文件，
用三句话说明这个项目的用途，
不要修改任何文件，也不要运行危险命令。把项目规则写进 Claude 每次都会读取的文件。
在项目根目录添加 CLAUDE.md，可保存架构约束、代码规范、测试命令和禁止事项。
项目背景
说明项目用途、技术栈、目录结构和关键模块。
代码规范
规定格式、命名、组件方式、错误处理和注释风格。
安全边界
明确不可修改的文件、不可执行的命令和敏感目录。
测试命令
告诉 Claude 修改后需要运行哪些测试、Lint 和构建命令。
Git 规则
规定分支、提交信息、Diff 审阅和禁止直接推送。
输出格式
要求先给计划、列出风险、说明改动并提供验证结果。
# Project Instructions
## Project
- This is the OmniDino website and documentation project.
- Keep the existing visual style and page structure.
- Prefer minimal, targeted changes.
## Coding Rules
- Use readable HTML, CSS and vanilla JavaScript.
- Keep all page classes scoped to the current page prefix.
- Preserve mobile responsiveness.
- Do not remove existing working sections without approval.
## Safety
- Never expose API keys, passwords or private configuration.
- Do not edit production credentials.
- Do not run deployment, database deletion or destructive commands without approval.
## Verification
- Review the final diff.
- Check desktop and mobile layouts.
- Confirm links and copy buttons work.
- Report every file changed and the reason.让 Claude Code 连接外部工具和数据。
MCP 是连接 AI 工具与外部服务的开放标准。只添加你理解并信任的 MCP Server。
Filesystem
在受控目录范围内读取和管理文件。
GitHub
读取仓库、Issue、Pull Request 和代码审阅信息。
Playwright
测试网页、自动操作浏览器并检查界面结果。
Database
连接受控数据库进行查询和分析，避免给予写入生产库权限。
Docker
读取容器状态和日志，谨慎开放创建、删除与执行权限。
Custom Tools
将自己的内部 API、文档系统和业务工具封装成 MCP。
# 在 Claude Code 中打开 MCP 管理界面
/mcp
# 查看 CLI MCP 帮助
claude mcp --help
# 将 Claude Code 自身作为 MCP Server
claude mcp serveANTHROPIC_AUTH_TOKEN 时，Claude.ai 账户中配置的云端 Connectors 可能不会自动载入。请在 Claude Code 中单独配置所需 MCP Server。
在 Claude Code 生命周期中自动运行检查。
Hooks 可以执行 Shell 命令、HTTP 请求或提示词，用于通知、格式化、测试和安全控制。
PreToolUse
在工具执行前检查命令、路径或权限。
PostToolUse
文件修改后自动格式化、Lint 或记录日志。
Notification
Claude 等待输入或授权时发送桌面通知。
Stop
任务结束时运行摘要、检查或结果归档。
自动测试
在关键修改后运行测试，尽早暴露错误。
安全阻止
拦截危险命令、敏感路径和不符合规则的操作。
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
}
]
}
]
}
}env 或其他配置，请合并 JSON 字段，不要直接覆盖整个文件。Windows 和 Linux 的通知命令与 macOS 不同。
以本机 claude –help 输出为准。
| 命令 | 用途 | 说明 |
|---|---|---|
claude | 启动交互式 Claude Code。 | 先进入正确的项目目录。 |
claude --version | 查看版本。 | 排查问题时记录版本号。 |
claude --help | 查看命令和参数。 | 不同版本功能可能变化。 |
claude -p "任务" | 打印模式，一次性执行任务。 | 适合脚本、管道和 CI。 |
claude mcp --help | 查看 MCP 管理命令。 | 用于添加、查看和管理 MCP。 |
claude mcp serve | 将 Claude Code 作为 MCP Server。 | 供其他 MCP 客户端连接。 |
/status | 检查 Base URL 和认证来源。 | 验证是否真正走 OmniDino。 |
/model | 查看或选择模型。 | 可用模型由网关和配置决定。 |
/permissions | 查看工具权限规则。 | 管理 allow、ask 与 deny。 |
/mcp | 打开 MCP 管理界面。 | 查看连接状态和服务器来源。 |
/bug | 向 Claude Code 项目报告问题。 | 也可在 GitHub Issues 提交。 |
从安装到第一次真实工程任务。
安装 Git 与 Claude Code
从官方 GitHub 项目确认安装方式，完成后检查版本。
创建 OmniDino API Key
为 Claude Code 单独创建令牌，并设置合理额度和模型权限。
配置 Gateway 环境变量
设置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和实际 Claude 模型名。
验证 /status
确认 Anthropic Base URL 显示 OmniDino，认证来源为 ANTHROPIC_AUTH_TOKEN。
创建 CLAUDE.md
写入项目背景、代码规范、安全边界、测试命令和审阅要求。
按需配置 MCP 和 Hooks
只添加可信工具，并从通知、格式化和测试等低风险功能开始。
在测试仓库运行任务
先让 Claude 读取 README、解释结构或完成一个小型可审阅修改。
检查 Diff 与 OmniDino 用量
确认文件变更、命令执行、调用记录和余额变化均符合预期。
连接失败时逐项排查。
Claude Code 仍然无法连接？
请提供操作系统、Claude Code 版本、安装方式、Base URL、认证变量名称、模型名称、HTTP 状态码和完整错误信息。请隐藏 API Key。
[email protected]