OmniDino
Home Models Pricing Guides About Contact Login Get API Key
EN 中文
Claude Code

In the terminal, let Claude understand, modify, and run your project.

Install Anthropic’s official Claude Code, connect Claude models through the OmniDino Anthropic Messages gateway, and complete development, debugging, testing, Git workflows, MCP integrations, and automation tasks in real repositories.

CLITerminal AgentRead files, run commands, and complete tasks inside the project directory.
GITGit WorkflowsAnalyze diffs, create commits, manage branches, and work with pull requests.
MCPExternal ToolsConnect data sources, services, and custom tools through MCP.
APIConnect OmniDinoUse available Claude models through the Anthropic Messages protocol.
Tool Overview

Claude Code is not an ordinary chatbot.

It can read an entire codebase, make changes across files, run commands, and keep working toward a development goal.

You describe the goal. Claude Code explores, plans, and executes.

It can explain project structure, trace the root cause of errors, implement features, write tests, fix failures, and handle Git workflows. Because it has file and command permissions, define clear project rules and permission boundaries before serious use.

Cross-File EngineeringUnderstand and modify multiple files around one feature or bug.
Composable CLISupports interactive mode, piped input, scripted tasks, and CI workflows.
Persistent Project RulesStore standards, architecture constraints, build commands, and checklists in CLAUDE.md.
Open-Source Download Center

Every downloadable tool links to a GitHub project.

CC

Anthropic Claude Code

Anthropic’s official Claude Code repository, with installation instructions, plugins, examples, and issue reporting.

WindowsmacOSLinuxTerminal Agent
SW

CC Switch

A cross-platform, open-source configuration manager that can store the OmniDino Base URL, API Key, and model settings for Claude Code.

WindowsmacOSLinuxVisual Configuration
VS

Visual Studio Code

An optional open-source editor for reviewing files, diffs, terminal output, and changes made by Claude Code.

EditorTerminalGitCross-Platform
The official Claude Code repository marks npm installation as deprecated. Prefer the native installer, Homebrew, or WinGet. Do not download modified installers from cloud drives or unknown download sites.
Install Claude Code

Choose the command that matches your terminal.

Windows PowerShell

Use Anthropic’s official PowerShell installer.

A PowerShell prompt usually begins with PS.
Install Git for Windows to use Bash-based tools.
Run claude --version after installation.
PowerShell
irm https://claude.ai/install.ps1 | iex

claude --version

Windows CMD

CMD and PowerShell use different commands. Do not mix them.

A CMD prompt usually starts with C:\ and has no PS prefix.
The installer removes the downloaded script when installation finishes.
If irm is not recognized, you are using CMD rather than PowerShell.
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

claude --version

macOS, Linux, or WSL

Use Anthropic’s official shell installer.

The native installation updates automatically in the background.
WSL does not require a separate Git for Windows installation.
Enter the project directory, then run claude.
Terminal
curl -fsSL https://claude.ai/install.sh | bash

claude --version

Homebrew

macOS and Linux environments with Homebrew support can install Claude Code through Cask.

The stable channel uses claude-code.
Homebrew installations do not update automatically.
Run brew upgrade regularly.
Homebrew
brew install --cask claude-code

# Upgrade later
brew upgrade claude-code

Windows WinGet

Install Claude Code through Windows Package Manager.

The package name is Anthropic.ClaudeCode.
WinGet installations do not update automatically.
Run the upgrade command regularly.
WinGet
winget install Anthropic.ClaudeCode

# Upgrade later
winget upgrade Anthropic.ClaudeCode
Connect OmniDino

Claude Code uses the Messages gateway.

OmniDino Keys are sent as Bearer tokens, so ANTHROPIC_AUTH_TOKEN is recommended.

OmniDino Parameters

Claude Code appends the Anthropic Messages paths to the Base URL. Enter the root address here without adding /v1.

Base URLhttps://api.omnidino.com
CredentialANTHROPIC_AUTH_TOKEN
HeaderAuthorization: Bearer
ProtocolAnthropic Messages
ModelThe exact Claude model name in OmniDino
Use ANTHROPIC_API_KEY only when your gateway explicitly requires x-api-key. For standard OmniDino Bearer Keys, use ANTHROPIC_AUTH_TOKEN.
~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.omnidino.com",
    "ANTHROPIC_AUTH_TOKEN": "PASTE_YOUR_OMNIDINO_API_KEY",
    "ANTHROPIC_MODEL": "ENTER_THE_ACTUAL_CLAUDE_MODEL_NAME"
  }
}
Do not place the API Key in a shared project .claude/settings.json. Use the user-level ~/.claude/settings.json or a session environment variable. On Windows, the path is %USERPROFILE%\.claude\settings.json.
Shell Environment Variables
export ANTHROPIC_BASE_URL="https://api.omnidino.com"
export ANTHROPIC_AUTH_TOKEN="PASTE_YOUR_OMNIDINO_API_KEY"
export ANTHROPIC_MODEL="ENTER_THE_ACTUAL_CLAUDE_MODEL_NAME"

claude
Verify the Connection

Check /status before starting a real task.

Check inside Claude Code

Launch Claude Code from the same terminal where you set the environment variables.

Launchclaude
Status/status
Model/model
Permissions/permissions
MCP/mcp
In /status, you should see the OmniDino Anthropic Base URL and ANTHROPIC_AUTH_TOKEN as the authentication source.
Minimal Test Task
Read only the README file in the current project.
Explain the purpose of this project in three sentences.
Do not modify any files or run dangerous commands.
CLAUDE.md

Store project rules in a file Claude reads every session.

Add CLAUDE.md to the project root to record architecture constraints, coding standards, test commands, and prohibited actions.

01

Project Context

Describe the project purpose, technology stack, directory structure, and key modules.

02

Coding Standards

Define formatting, naming, component patterns, error handling, and comment style.

03

Safety Boundaries

Specify protected files, prohibited commands, and sensitive directories.

04

Test Commands

Tell Claude which tests, lint checks, and build commands to run after changes.

05

Git Rules

Define branch policy, commit messages, diff review, and restrictions on direct pushes.

06

Output Format

Require a plan first, a list of risks, a summary of changes, and verification results.

CLAUDE.md Template
# 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.
MCP

Connect Claude Code to external tools and data.

MCP is an open standard for connecting AI tools to external services. Add only MCP Servers that you understand and trust.

FS

Filesystem

Read and manage files only within approved directories.

GH

GitHub

Read repositories, Issues, pull requests, and code-review information.

PW

Playwright

Test websites, automate browser actions, and inspect interface results.

DB

Database

Query and analyze controlled databases without granting write access to production data.

DK

Docker

Read container status and logs. Grant create, delete, and exec permissions cautiously.

API

Custom Tools

Wrap internal APIs, documentation systems, and business tools as MCP services.

Common MCP Entry Points
# Open MCP management inside Claude Code
/mcp

# View MCP CLI help
claude mcp --help

# Run Claude Code itself as an MCP Server
claude mcp serve
When using ANTHROPIC_AUTH_TOKEN with the OmniDino Gateway, cloud Connectors configured in a Claude.ai account may not load automatically. Configure the required MCP Servers separately in Claude Code.
Hooks

Run checks automatically throughout the Claude Code lifecycle.

Hooks can run shell commands, HTTP requests, or prompts for notifications, formatting, testing, and security controls.

PRE

PreToolUse

Check commands, paths, or permissions before a tool runs.

POST

PostToolUse

Format files, run lint checks, or write logs after changes.

NTF

Notification

Send a desktop notification when Claude waits for input or approval.

STOP

Stop

Run summaries, checks, or result archiving when a task finishes.

TEST

Automated Tests

Run tests after important changes to expose errors early.

SAFE

Safety Blocking

Block dangerous commands, sensitive paths, and actions that violate rules.

~/.claude/settings.json · macOS Notification Example
{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}
If settings.json already contains env or other configuration, merge the JSON fields instead of replacing the entire file. Notification commands differ on Windows, Linux, and macOS.
Common Commands

Use the output of claude –help on your machine as the source of truth.

CommandPurposeNotes
claudeStart interactive Claude Code.Enter the correct project directory first.
claude --versionShow the version.Record it during troubleshooting.
claude --helpShow commands and options.Features may change between versions.
claude -p "TASK"Run a one-off task in print mode.Useful for scripts, pipelines, and CI.
claude mcp --helpShow MCP management commands.Use them to add, inspect, and manage MCP.
claude mcp serveRun Claude Code as an MCP Server.Allows other MCP clients to connect.
/statusCheck the Base URL and authentication source.Verify that requests actually use OmniDino.
/modelView or select the model.Available models depend on gateway and configuration.
/permissionsView tool-permission rules.Manage allow, ask, and deny behavior.
/mcpOpen MCP management.Review connection status and server sources.
/bugReport an issue to the Claude Code project.You can also submit a GitHub Issue.
Complete Workflow

From installation to your first real engineering task.

01

Install Git and Claude Code

Confirm the installation method in the official GitHub project, then verify the version.

02

Create an OmniDino API Key

Create a dedicated token for Claude Code and set sensible spending and model permissions.

03

Configure Gateway Environment Variables

Set ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, and the exact Claude model name.

04

Verify /status

Confirm that the Anthropic Base URL shows OmniDino and authentication uses ANTHROPIC_AUTH_TOKEN.

05

Create CLAUDE.md

Record project context, coding standards, safety boundaries, test commands, and review requirements.

06

Add MCP and Hooks as Needed

Add only trusted tools, starting with low-risk functions such as notifications, formatting, and tests.

07

Run a Task in a Test Repository

First ask Claude to read the README, explain the structure, or complete a small reviewable change.

08

Review the Diff and OmniDino Usage

Confirm that file changes, command execution, request logs, and balance changes match expectations.

FAQ

Troubleshoot connection problems one item at a time.

Reopen the terminal, confirm installation completed, and check PATH. Windows users should also verify that they used the correct PowerShell or CMD command.
The Gateway environment variables did not reach the current process. Set ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN in the same terminal before running claude, then check /status.
For Claude Code with OmniDino, use the root address https://api.omnidino.com. Claude Code accesses the required Messages Gateway paths automatically, so do not add /v1 mechanically.
Confirm that you used ANTHROPIC_AUTH_TOKEN rather than the wrong authentication variable. Check that the Key is complete and valid, and that OmniDino accepts Bearer tokens.
Copy the exact Claude model name from the OmniDino model catalog, confirm that a channel is bound to the model, and check the token group permissions.
Verify the NewAPI channel type, upstream protocol, and Claude Messages conversion. Working Chat Completions do not guarantee that Claude Messages will also work.
Check the command, dependencies, environment variables, working directory, and permissions. Run /mcp to view the error, then test the MCP Server launch command directly in the terminal.
Confirm the filename and capitalization, and place it in the project root or a parent directory Claude Code reads. Restart the session before testing the rules again.
Use Git branches, least privilege, explicit CLAUDE.md rules, and /permissions. Do not expose production secrets or automatically approve deployment, deletion, or database-write commands.

Still unable to connect Claude Code?

Provide the operating system, Claude Code version, installation method, Base URL, authentication variable name, model name, HTTP status code, and complete error message. Hide the API Key.

[email protected]
Continue Reading

Move to the next client guide.