From 879971630fa2cc6b276c4805ab06cebe92da2864 Mon Sep 17 00:00:00 2001 From: mingcheng Date: Sun, 15 Feb 2026 15:42:43 +0800 Subject: [PATCH 1/6] Update Hugo version and fix configuration for pagination and social media metadata --- .github/workflows/gh-pages.yml | 2 +- config.yml | 3 ++- themes/PaperMod/layouts/partials/header.html | 2 +- themes/PaperMod/layouts/partials/templates/opengraph.html | 3 ++- themes/PaperMod/layouts/partials/templates/twitter_cards.html | 2 +- 5 files changed, 7 insertions(+), 5 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index bc65d74..9c490a0 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -20,7 +20,7 @@ jobs: - name: Setup Hugo uses: peaceiris/actions-hugo@v2 with: - hugo-version: '0.106.0' + hugo-version: '0.155' extended: true - name: Build diff --git a/config.yml b/config.yml index 214e6fd..a096958 100644 --- a/config.yml +++ b/config.yml @@ -1,6 +1,7 @@ baseURL: "https://inclusionai.github.io/" title: INCLUSION AI -paginate: 5 +pagination: + pagerSize: 5 theme: PaperMod enableRobotsTXT: true diff --git a/themes/PaperMod/layouts/partials/header.html b/themes/PaperMod/layouts/partials/header.html index 2159757..993fb34 100644 --- a/themes/PaperMod/layouts/partials/header.html +++ b/themes/PaperMod/layouts/partials/header.html @@ -140,7 +140,7 @@ {{- range site.Menus.main }} {{- $menu_item_url := (cond (strings.HasSuffix .URL "/") .URL (printf "%s/" .URL) ) }} {{- $page_url:= $currentPage.RelPermalink }} - {{- $is_search := eq ($sites.First.GetPage .KeyName).Layout `search` }} + {{- $is_search := eq ($sites.Default.GetPage .KeyName).Layout `search` }}
  • diff --git a/themes/PaperMod/layouts/partials/templates/opengraph.html b/themes/PaperMod/layouts/partials/templates/opengraph.html index 9e8df14..4fc4eff 100644 --- a/themes/PaperMod/layouts/partials/templates/opengraph.html +++ b/themes/PaperMod/layouts/partials/templates/opengraph.html @@ -49,4 +49,5 @@ {{ end }}{{ end }} {{- /* Facebook Page Admin ID for Domain Insights */}} -{{- with site.Social.facebook_admin }}{{ end }} +{{- with site.Params.Social.facebook_admin }} +{{ end }} diff --git a/themes/PaperMod/layouts/partials/templates/twitter_cards.html b/themes/PaperMod/layouts/partials/templates/twitter_cards.html index bd46e37..0efc545 100644 --- a/themes/PaperMod/layouts/partials/templates/twitter_cards.html +++ b/themes/PaperMod/layouts/partials/templates/twitter_cards.html @@ -28,6 +28,6 @@ {{- end }} -{{ with site.Social.twitter -}} +{{ with site.Params.Social.twitter -}} {{ end -}} From 92d8659a8967e7ca359d6ebb760e10c7aefc4b96 Mon Sep 17 00:00:00 2001 From: mingcheng Date: Sun, 15 Feb 2026 16:29:07 +0800 Subject: [PATCH 2/6] Add new blog post: Using Ring 1T with Claude Code via ZenMux --- .../index.md | 842 ++++++++++++++++++ 1 file changed, 842 insertions(+) create mode 100644 content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md diff --git a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md new file mode 100644 index 0000000..302a35c --- /dev/null +++ b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md @@ -0,0 +1,842 @@ +--- +title: "Using Ring 1T with Claude Code via ZenMux" +date: 2026-02-15T00:00:03+08:00 +weight: 1 +math: true +# search_hidden: false # to hide from search page +show_reading_time: true +show_bread_crumbs: true +show_post_nav_links: false # the prev/next after the content +show_code_copy_buttons: true +show_word_count: true +--- + +# Using Ring 1T with Claude Code via ZenMux + +## What is Ring 1T? + +Ring 1T is a powerful open-source reasoning model designed for complex problem-solving and advanced coding tasks. It's built on the Ling 2.0 architecture with impressive capabilities: + +- **Scale**: 1 trillion total parameters with 50 billion activated parameters +- **Context**: Supports up to 128K tokens context window +- **Training**: Enhanced through large-scale verifiable reward reinforcement learning (RLVR) +- **Strengths**: Excels at deep reasoning, natural language inference, and sophisticated code generation + +Ring 1T represents the latest advancement in MoE (Mixture of Experts) architecture scaling, leveraging the icepop reinforcement learning stabilization method and the ASystem framework to deliver exceptional reasoning performance. + +**Open Source**: Download model weights from [Hugging Face](https://huggingface.co/inclusionAI/Ring-1T), [ModelScope](https://modelscope.cn/models/inclusionAI/Ring-1T), and [ZenMux](https://zenmux.ai/inclusionai/ring-1t). + +## What is ZenMux? + +ZenMux is an enterprise-grade AI model aggregation platform that provides unified access to leading language models worldwide. Key features include: + +- **Unified API**: Access models from OpenAI, Anthropic, Google, DeepSeek, and more through a single interface +- **Intelligent Routing**: Automatically select optimal models based on your needs +- **High Availability**: Built-in failover mechanisms ensure reliability +- **Quality Assurance**: AI model insurance services (coming soon) to address concerns about hallucinations and output instability + +With ZenMux, developers can seamlessly integrate multiple AI models without managing different APIs or endpoints. + +## What is Claude Code? + +Claude Code is Anthropic's official AI coding agent that helps you write, debug, and understand code directly from your terminal or VSCode. It combines: + +- **Natural conversation**: Interact with AI using natural language +- **Code awareness**: Understands your project structure and context +- **Direct execution**: Reads files, makes edits, and runs commands +- **Flexibility**: Works as both a CLI tool and VSCode extension + +Claude Code is designed to be your AI pair programmer, handling everything from simple code questions to complex multi-file refactoring. + +## Why Ring 1T with Claude Code via ZenMux? + +Combining these three tools gives you: + +- **Ring 1T's advanced reasoning** for complex coding challenges +- **Claude Code's intuitive interface** for seamless interaction +- **ZenMux's unified platform** for easy model access and management + +This guide walks you through configuring Claude Code to use Ring 1T through ZenMux—it takes just a few environment variables. The key setting is: `ANTHROPIC_BASE_URL="https://zenmux.ai/api/anthropic"` + +## Getting Started: Installation & Configuration + +### Step 1: Install Claude Code + +**Important Update: npm/pnpm Installation Is Deprecated** + +The npm/pnpm installation method for Claude Code has been deprecated. If you previously installed via npm/pnpm, first uninstall the old version: + +```bash +npm uninstall -g @anthropic-ai/claude-code +# or +pnpm uninstall -g @anthropic-ai/claude-code +``` + +Then use the new native installation method. + +**Recommended: Native Installation** + +**macOS/Linux/WSL:** +```bash +curl -fsSL https://claude.ai/install.sh | bash +``` + +**Windows PowerShell:** +```powershell +irm https://claude.ai/install.ps1 | iex +``` + +**Windows CMD:** +```batch +curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd +``` + +**Package Managers (manual updates required):** + +Homebrew (macOS): +```bash +brew install --cask claude-code +``` + +WinGet (Windows): +```powershell +winget install Anthropic.ClaudeCode +``` + +**Installation Notes** +- Native installers auto-update automatically +- Package manager installs require manual updates via `brew upgrade claude-code` or `winget upgrade Anthropic.ClaudeCode` +- After installation, verify with: `claude doctor` +- For full details, see [Claude Code installation docs](https://code.claude.com/docs/en/setup) + +### Configure Claude Code + +#### How the Configuration Works + +By default, Claude Code connects to Anthropic's service. To use Ring 1T, we redirect requests to ZenMux using environment variables. This approach: + +- **Requires no changes to Claude Code**: Just set environment variables +- **Uses your ZenMux API Key**: Simple authentication +- **Enables Ring 1T access**: Use the powerful reasoning model in Claude Code + +The setup involves two key environment variables: `ANTHROPIC_BASE_URL` (ZenMux endpoint) and `ANTHROPIC_AUTH_TOKEN` (your ZenMux API Key). This routes all Claude Code requests through ZenMux to Ring 1T. + +> **Important Change in v2.0.7x** +> +> Due to updates in Claude Code v2.0.7x, its **environment-variable loading logic has changed**: the `env` config in `~/.claude/settings.json` **cannot be reliably read** in the following scenarios: +> +> - When **logging in for the first time** in Claude Code +> - When logging in again after running **logout** +> +> Therefore, when connecting to ZenMux, it’s recommended to standardize on **shell profile environment variables** to ensure both login and requests go through ZenMux’s Anthropic-compatible endpoint. + +### Step 2: Get a ZenMux API Key + +Before configuring Claude Code, obtain a ZenMux API Key. ZenMux offers two billing options: + +```text [Subscription API Key (Recommended)] +Best for: Personal development, learning/exploration, Vibe Coding +Features: Fixed monthly fee, predictable cost, 5–10x price advantage +API Key format: `sk-ss-v1-xxx` + +Getting started: +1. Visit the [subscription management page](https://zenmux.ai/platform/subscription) +2. Choose a plan (Pro $20/mo, Max $100/mo, Ultra $200/mo) +3. Create a subscription API Key after subscribing + +For more details, see the [Subscription Plan Guide](https://docs.zenmux.ai/guide/subscription) +``` + +```text [Pay-as-you-go API Key] +Best for: Production, commercial products, enterprise applications +Features: No rate limits, production-grade stability, pay-per-use billing +API Key format: `sk-ai-v1-xxx` + +Getting started: +1. Visit the [pay-as-you-go page](https://zenmux.ai/platform/pay-as-you-go) +2. Top up your account (includes 20% bonus credit automatically) +3. Create an API Key in the "Pay-as-you-go API Keys" section + +For more details, see the [Pay-as-you-go Guide](https://docs.zenmux.ai/guide/pay-as-you-go) +``` + +> **Important: Choose the Right API Key Type** +> +> - **For personal development or learning** → Use a **Subscription API Key** (`sk-ss-v1-xxx`) for better value and lower cost +> - **For production or commercial projects** → Use a **Pay-as-you-go API Key** (`sk-ai-v1-xxx`) for higher stability and no limits +> +> Note: Subscription keys are not allowed for production use. Using them incorrectly may result in account restrictions. + +### Step 3: Configure Claude Code + +#### How the Configuration Works + +By default, Claude Code connects to Anthropic's official service. To use Ring 1T via ZenMux, redirect requests using environment variables: + +- **No changes needed to Claude Code itself** — just set two environment variables +- **Simple authentication** — use your ZenMux API Key +- **Transparent redirection** — all requests route through ZenMux to Ring 1T + +The configuration uses two key variables: +- `ANTHROPIC_BASE_URL` — points to ZenMux's Anthropic-compatible endpoint +- `ANTHROPIC_AUTH_TOKEN` — your ZenMux API Key for authentication + +> **Important: Claude Code v2.0.7x Environment Variable Loading** +> +> In Claude Code v2.0.7x and later, environment variables in `~/.claude/settings.json` **cannot be reliably loaded** during: +> - First-time login +> - Login after running `logout` +> +> **Recommendation**: Use **shell profile environment variables** (as shown below) to ensure consistent availability during both login and API requests through ZenMux. + +#### Option 1: Shell Profile Configuration (Recommended) + +```bash +# 1. Determine which shell you are using (usually bash or zsh): +# - If using bash, edit ~/.bashrc +# - If using zsh, edit ~/.zshrc +# - If you're not sure, run echo $SHELL + +# 2. Append the following to the end of the corresponding config file (replace the API Key) + +# ============= ZenMux + Claude Code Configuration ============= +# Connect Claude Code to ZenMux instead of Anthropic’s official service + +# Core settings: ZenMux endpoint and authentication +export ANTHROPIC_BASE_URL="https://zenmux.ai/api/anthropic" # ZenMux Anthropic-compatible endpoint +export ANTHROPIC_AUTH_TOKEN="sk-ss-v1-xxx" # Replace with your ZenMux API Key (subscription sk-ss-v1-xxx or pay-as-you-go sk-ai-v1-xxx) +export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" # Disable non-essential traffic +export API_TIMEOUT_MS="30000000" # API timeout in milliseconds + +# Avoid conflicts: if you previously set ANTHROPIC_API_KEY locally, explicitly clear it +export ANTHROPIC_API_KEY="" + +# Model configuration: Set Ring 1T as your default model +# Ring 1T excels at reasoning and complex coding tasks +export ANTHROPIC_DEFAULT_HAIKU_MODEL="inclusionai/ring-1t" # Fast tier +export ANTHROPIC_DEFAULT_SONNET_MODEL="inclusionai/ring-1t" # Balanced tier (recommended) +export ANTHROPIC_DEFAULT_OPUS_MODEL="inclusionai/ring-1t" # Most capable tier + +# 3. Apply the configuration (choose one): +# Option 1: Reload the config file (recommended) +source ~/.bashrc # if using bash +# or +source ~/.zshrc # if using zsh + +# Option 2: Restart the terminal window +``` + +On Windows, the process is similar but uses PowerShell and the PowerShell Profile: + +```powershell [Windows PowerShell] +# ============== Steps ============== + +# On Windows, use the PowerShell Profile to configure environment variables +# PowerShell 7+ is recommended for a better experience + +# 1. Check whether the PowerShell Profile exists +Test-Path $PROFILE + +# 2. If it returns False, create the Profile file +if (!(Test-Path $PROFILE)) { + New-Item -Path $PROFILE -ItemType File -Force +} + +# 3. Open the Profile file for editing +notepad $PROFILE +# If you use VSCode, you can also run: code $PROFILE + +# 4. Append the following to the end of the Profile file (replace the API Key) + +# ============= ZenMux + Claude Code Configuration ============= +# Connect Claude Code to ZenMux instead of Anthropic’s official service + +# Core settings: ZenMux endpoint and authentication +$env:ANTHROPIC_BASE_URL = "https://zenmux.ai/api/anthropic" # ZenMux Anthropic-compatible endpoint +$env:ANTHROPIC_AUTH_TOKEN = "sk-ss-v1-xxx" # Replace with your ZenMux API Key (subscription sk-ss-v1-xxx or pay-as-you-go sk-ai-v1-xxx) +$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1" # Disable non-essential traffic +$env:API_TIMEOUT_MS = "30000000" # API timeout in milliseconds + +# Avoid conflicts: if you previously set ANTHROPIC_API_KEY locally, explicitly clear it +$env:ANTHROPIC_API_KEY = "" + + +# Model configuration: Set Ring 1T as your default model +# Ring 1T excels at reasoning and complex coding tasks +# https://zenmux.ai/inclusionAI/ring-1t +$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "inclusionai/ring-1t" # Fast tier +$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "inclusionai/ring-1t" # Balanced tier (recommended) +$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "inclusionai/ring-1t" # Most capable tier + +# 5. Save the file, then restart PowerShell to apply +# Or run this in the current window: . $PROFILE + +# 6. Verify the environment variables were set successfully +Write-Host "ANTHROPIC_BASE_URL: $env:ANTHROPIC_BASE_URL" +Write-Host "ANTHROPIC_AUTH_TOKEN: $env:ANTHROPIC_AUTH_TOKEN" +``` + +> **Important: Replace the API Key** +> +> Be sure to replace `sk-ss-v1-xxx` or `sk-ai-v1-xxx` in the configuration with your real ZenMux API Key: +> +> **Subscription API Key (recommended for personal development)** +> +> - Format: `sk-ss-v1-xxx` +> - Get it from: [Subscription management page](https://zenmux.ai/platform/subscription) +> - Detailed guide: [Subscription plan docs](/guide/subscription) +> +> **Pay-as-you-go API Key (production)** +> +> - Format: `sk-ai-v1-xxx` +> - Get it from: [Pay-as-you-go page](https://zenmux.ai/platform/pay-as-you-go) +> - Detailed guide: [Pay-as-you-go docs](/guide/pay-as-you-go) + +### Environment Variable Reference + +| Variable | Purpose | Notes | +| ---------------------- | ---------------- | --------------------------------------------------- | +| `ANTHROPIC_BASE_URL` | Service endpoint | Redirects Claude Code requests to ZenMux | +| `ANTHROPIC_AUTH_TOKEN` | Auth token | Your ZenMux API Key (subscription or pay-as-you-go) | + +### Step 4: Launch Claude Code + +Open a new terminal window to load the environment variables, then start Claude Code: + +1. Go to your project directory: + + ```bash + cd /path/to/your/project + ``` + +2. Start Claude Code: + + ```bash + claude + ``` + +3. On first launch, Claude Code will automatically: + - Read `ANTHROPIC_AUTH_TOKEN` from your environment variables + - Authenticate through the ZenMux Anthropic-compatible endpoint + - Begin working immediately\u2014no additional login needed + +**If you encounter issues:** + +- The `claude` command not found \u2192 Verify Claude Code is installed globally (see the installation steps above) + +### Step 5: Verify the Connection + +After launching successfully, run `/status` in Claude Code to verify the connection. The output should display: + +```text +Auth token: ANTHROPIC_AUTH_TOKEN +Anthropic base URL: https://zenmux.ai/api/anthropic +``` + +**What to check:** + +- `Auth token` displays `ANTHROPIC_AUTH_TOKEN` (loaded from environment variables) +- `Anthropic base URL` displays `https://zenmux.ai/api/anthropic` (the ZenMux endpoint) + +If the configuration is correct, your setup is complete—start leveraging Ring 1T's reasoning capabilities in Claude Code. + +## Using Claude Code: CLI vs VSCode Extension + +You can use Claude Code in two ways. Choose based on your preferences: + +### CLI (Command-Line) - Recommended + +**When to use**: You prefer command-line tools, want automatic environment variable loading, or need to work across multiple projects. + +The CLI automatically loads environment variables from your shell profile (Steps 1-5 above): + +```bash +cd /path/to/your/project +claude +``` + +**Advantages:** +- Environment variables load automatically from shell profile +- No additional configuration needed in VSCode +- Works consistently across all projects in that shell +- Lightweight and straightforward + +### VSCode Extension + +**When to use**: You prefer an integrated development environment, want settings isolated to VSCode, or use VSCode as your primary editor. + +Configure Claude Code directly in VSCode settings: + +#### Step 1: Install the Extension + +Search for "Claude Code" in the VSCode Extensions marketplace and install it. Once installed, the Claude Code icon will appear in your sidebar. + +
    + Install Claude Code Extension +
    + +#### Step 2: Open Settings + +Click the extension's **Settings** icon to open the configuration page: + +
    + Open Claude Code settings +
    + +#### Step 3: Configure the Model and Environment Variables + +Click **Edit in settings.json** and add or modify the following configuration: + +```json +{ + "claude-code.selectedModel": "inclusionai/ring-1t", + "claudeCode.environmentVariables": [ + { + "name": "ANTHROPIC_BASE_URL", + "value": "https://zenmux.ai/api/anthropic" + }, + { + "name": "ANTHROPIC_AUTH_TOKEN", + "value": "sk-ss-v1-xxx" + }, + { + "name": "API_TIMEOUT_MS", + "value": "3000000" + }, + { + "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", + "value": "1" + }, + { + "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", + "value": "inclusionai/ring-1t" + }, + { + "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", + "value": "inclusionai/ring-1t" + }, + { + "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", + "value": "inclusionai/ring-1t" + } + ] +} +``` + +**Important Configuration Notes:** + +1. **Replace the API Key**: Replace `sk-ss-v1-xxx` with your real ZenMux API Key + - Subscription API Key (`sk-ss-v1-xxx`): best for personal development + - Pay-as-you-go API Key (`sk-ai-v1-xxx`): best for production + +2. **Configuration priority**: + - If you previously configured shell environment variables in the CLI (`~/.bashrc` / `~/.zshrc` / PowerShell Profile), the VSCode extension will prefer the `settings.json` configuration + - To avoid conflicts, when using the VSCode extension, configure environment variables only in `settings.json` + +3. **Model selection**: + - `claude-code.selectedModel` sets Ring 1T as the active model + - `ANTHROPIC_DEFAULT_*_MODEL` configures Ring 1T across all speed tiers + - Use `/model` command during sessions to verify or switch models + +#### Step 4: Start Using It + +After configuration, you can start using the Claude Code extension: + +1. Click the Claude Code icon in the VSCode sidebar +2. On first use, click **Trust This Folder** to grant access to your project files +3. Start a conversation by entering your question or task +4. Claude will automatically read and analyze your project files to help you + +**Useful Commands** + +- `/model` — View the current model or switch to another +- `/status` — Check connection status and verify the configuration is correct +- `/help` — Display all available commands + +> **Note**: If you encounter authentication issues in VSCode, ensure that `ANTHROPIC_AUTH_TOKEN` and `ANTHROPIC_BASE_URL` are only configured in `settings.json` to avoid conflicts with system environment variables. + + + +## What It Looks Like + +Once set up, Ring 1T is ready to use in Claude Code: + +
    + Claude Code +
    + +Use the `/model` command to confirm Ring 1T is active: + +
    + Claude Code /model command output +
    + +## Next Steps & Useful Commands + +Now that you have Ring 1T configured with Claude Code, here are some ways to get started: + +**Recommended First Tasks:** +- Ask Claude Code to explain or refactor existing code in your project +- Request help with complex algorithms or system design problems +- Use Ring 1T's reasoning capabilities for debugging difficult issues + +**Useful Commands in Claude Code:** +- `/model` — View the current model or switch to another +- `/status` — Check connection status and verify the configuration +- `/help` — Display all available commands +- `/pwd` — Show current working directory +- `/clear` — Clear conversation history + +**Explore More Models:** +- Browse all available models on [ZenMux's model list](https://zenmux.ai/models) +- Switch models using `/model` command during your session +- Compare Ring 1T with other reasoning models for different use cases + +**Learn More:** +- Read [Claude Code documentation](https://code.claude.com/docs) for advanced features +- Check [ZenMux documentation](https://docs.zenmux.ai) for platform details +- See the [Ring 1T model page](https://zenmux.ai/inclusionai/ring-1t) for model specifics + +## Troubleshooting + +### Common Issues + +#### API Key Error or Authentication Failure + +**Issue**: You see messages like “invalid API key,” “unauthorized,” or authentication failed. + +**Solution**: + +1. **Check the API Key format**: + - Subscription API keys should start with `sk-ss-v1-` + - Pay-as-you-go API keys should start with `sk-ai-v1-` + - Ensure there are no extra spaces or newline characters + +2. **Validate the API Key**: + - Subscription: visit the [subscription management page](https://zenmux.ai/platform/subscription) to check subscription status and quota + - Pay-as-you-go: visit the [pay-as-you-go page](https://zenmux.ai/platform/pay-as-you-go) to confirm sufficient balance + +3. **Confirm environment variables are loaded**: + + ```bash + # macOS/Linux + echo $ANTHROPIC_AUTH_TOKEN + + # Windows PowerShell + echo $env:ANTHROPIC_AUTH_TOKEN + ``` + + If the output is empty, the environment variables were not loaded correctly. Re-run `source ~/.zshrc` or restart the terminal. + +4. **Check the API Key status**: + - Confirm the API key is shown as "Enabled" in the console + - Check whether the API key has been deleted or disabled + +5. **Get a new API Key**: + - [Subscription API Key guide](/guide/subscription#step-3-manage-your-subscription-and-get-an-api-key) + - [Pay-as-you-go API Key guide](/guide/pay-as-you-go#create-and-manage-api-keys) + +#### Authentication Failure When Switching from Another Platform to ZenMux + +**Issue**: You previously used a Claude Code official account or another platform (e.g., MiniMax, GLM, etc.). After switching to ZenMux, authentication fails or configuration conflicts occur. + +**Solution**: + +This usually happens because old config files cached prior authentication info, causing conflicts with the new ZenMux configuration. Clean up and reconfigure as follows: + +1. **Delete the old config file**: + + ```bash [macOS/Linux] + # Delete Claude Code config + rm -rf ~/.claude/settings.json + ``` + + ```powershell [Windows PowerShell] + # Delete Claude Code config + Remove-Item -Path "$env:USERPROFILE\.claude\settings.json" -Force + ``` + +2. **Confirm your shell environment variables are configured correctly**: + + Check whether your shell config file (`~/.zshrc` or `~/.bashrc`) contains the full ZenMux configuration. Refer to [Step 1: Configure Shell Environment Variables](#step-1-configure-shell-environment-variables) above, and ensure it includes these key variables: + + ```bash + export ANTHROPIC_BASE_URL="https://zenmux.ai/api/anthropic" + export ANTHROPIC_AUTH_TOKEN="sk-ss-v1-xxx" # Replace with your ZenMux API Key + export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" + export API_TIMEOUT_MS="30000000" + export ANTHROPIC_API_KEY="" # Clear to avoid conflicts + export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5" + export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.5" + export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.5" + ``` + +3. **Reload environment variables**: + + ```bash [Using zsh] + source ~/.zshrc + ``` + + ```bash [Using bash] + source ~/.bashrc + ``` + + ```powershell [Windows PowerShell] + . $PROFILE + ``` + +4. **Verify environment variables are applied**: + + ```bash [macOS/Linux] + # Check ZenMux endpoint + echo $ANTHROPIC_BASE_URL + # Should output: https://zenmux.ai/api/anthropic + + # Check whether the API Key is set + echo $ANTHROPIC_AUTH_TOKEN + # Should output your ZenMux API Key + + # Confirm the old API Key is cleared + echo $ANTHROPIC_API_KEY + # Should output empty + ``` + + ```powershell [Windows PowerShell] + # Check ZenMux endpoint + Write-Host "ANTHROPIC_BASE_URL: $env:ANTHROPIC_BASE_URL" + # Should output: https://zenmux.ai/api/anthropic + + # Check whether the API Key is set + Write-Host "ANTHROPIC_AUTH_TOKEN: $env:ANTHROPIC_AUTH_TOKEN" + # Should output your ZenMux API Key + + # Confirm the old API Key is cleared + Write-Host "ANTHROPIC_API_KEY: $env:ANTHROPIC_API_KEY" + # Should output empty + ``` + +5. **Restart Claude Code**: + + ```bash + # Enter your project directory + cd /path/to/your/project + + # Start Claude Code + claude + ``` + +6. **Verify the connection**: + + After starting, run `/status` in Claude Code and confirm it shows: + + ```text + Auth token: ANTHROPIC_AUTH_TOKEN + Anthropic base URL: https://zenmux.ai/api/anthropic + ``` + +#### The Model Does Not Support the Anthropic Protocol + +**Issue**: When using a model, you see a message saying it does not support the Anthropic protocol. + +**Solution**: + +- Use the [ZenMux model list](https://zenmux.ai/models) and filter by "Anthropic API Compatible" to see currently supported models +- Or open the model’s detail page to confirm Anthropic protocol support +- Choose a model from the supported list above + +#### Connection Failures + +**Issue**: Claude Code cannot connect to the ZenMux service. + +**Solution**: + +- Check that your network connection is working +- Verify `ANTHROPIC_BASE_URL` is set to `https://zenmux.ai/api/anthropic` +- Confirm your firewall is not blocking outbound connections + +#### VSCode Claude Code Extension Configuration Issues + +**Issue**: In the VSCode Claude Code extension, you encounter issues such as authentication failures or models not working. + +**Solution**: + +1. **Confirm the environment variables are configured correctly**: + - Open VSCode Settings (`Cmd/Ctrl + ,`) + - Search for "Claude Code" + - Click "Edit in settings.json" + - Confirm `claudeCode.environmentVariables` includes correct `ANTHROPIC_BASE_URL` and `ANTHROPIC_AUTH_TOKEN` + +2. **Check the model configuration**: + - Search for "claude-code.selectedModel" in Settings + - Confirm it's set to `ring/ring-1t` + - Verify the model name format is correct + +3. **Resolve environment variable conflicts**: + - The VSCode extension’s `settings.json` configuration has higher priority than system environment variables + - If you previously set environment variables in your shell profile, it’s recommended to keep only one source of configuration + - Avoid setting `ANTHROPIC_AUTH_TOKEN` in multiple places, which can cause conflicts + +4. **Restart VSCode**: + - After changing configuration, fully quit and relaunch VSCode + - Reopen the project so the new configuration takes effect + +5. **Check extension logs**: + - Open the Output panel in VSCode (`View > Output`) + - Select the "Claude Code" channel + - Review detailed error messages to help diagnose the issue + +6. **Verify the connection**: + - In the Claude Code chat UI, type `/status` + - Confirm the displayed API endpoint and authentication method are correct + +For detailed configuration steps, see the [Use the Claude Code Extension in VSCode](#use-the-claude-code-extension-in-vscode) section above. + +#### Windows PowerShell Script Execution Policy Issue + +**Issue**: PowerShell shows: “Cannot load file xxx because running scripts is disabled on this system.” + +**Solution**: + +This is a Windows PowerShell security mechanism. You need to change the execution policy: + +1. Run PowerShell **as Administrator** +2. Execute: + + ```powershell + Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser + ``` + +3. Type `Y` to confirm +4. Reopen the PowerShell window + +**Execution policy reference**: + +- `Restricted` (default): no scripts can run +- `RemoteSigned`: local scripts can run; downloaded scripts require a digital signature +- `Unrestricted`: all scripts can run (not recommended) + +#### Windows: `claude` Command Not Found + +**Issue**: After installing Claude Code, PowerShell cannot find the `claude` command. + +**Solution**: + +This is usually caused by the npm global package path not being added to the PATH environment variable. + +1. Check the npm global prefix: + + ```powershell + npm config get prefix + ``` + +2. Check whether that path is in PATH: + + ```powershell + $env:PATH -split ";" | Select-String "npm" + ``` + +3. If it isn’t, add it manually (choose one): + + **Option 1: Temporary (current session only)** + + ```powershell + $env:PATH += ";C:\Users\\AppData\Roaming\npm" + ``` + + **Option 2: Permanent (recommended)** + + ```powershell + [Environment]::SetEnvironmentVariable( + "Path", + [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Users\\AppData\Roaming\npm", + "User" + ) + ``` + +4. Close and reopen PowerShell +5. Verify the installation: + + ```powershell + claude --version + ``` + +#### Windows PowerShell Profile Not Taking Effect + +**Issue**: You configured the PowerShell Profile, but the environment variables are not loaded. + +**Solution**: + +1. Confirm the Profile file path is correct: + + ```powershell + $PROFILE + # Should show something like: C:\Users\\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 + ``` + +2. Confirm the Profile file exists: + + ```powershell + Test-Path $PROFILE + # Should return True + ``` + +3. Confirm the Profile file content is correct: + + ```powershell + Get-Content $PROFILE + ``` + +4. Manually load the Profile (to test for syntax errors): + + ```powershell + . $PROFILE + ``` + +5. If errors occur, check: + - Whether the file encoding is UTF-8 + - Whether the PowerShell syntax is correct (note the `$env:` prefix) + - Whether the execution policy allows scripts (see "PowerShell Script Execution Policy Issue" above) + +6. Verify environment variables are loaded: + + ```powershell + Write-Host "ANTHROPIC_BASE_URL: $env:ANTHROPIC_BASE_URL" + Write-Host "ANTHROPIC_AUTH_TOKEN: $env:ANTHROPIC_AUTH_TOKEN" + ``` + +#### Windows: Chinese Characters in Environment Variables + +**Issue**: Garbled text appears when environment variables contain Chinese paths or values. + +**Solution**: + +1. Ensure the PowerShell Profile file uses **UTF-8 with BOM** encoding +2. Set the correct encoding in PowerShell: + + ```powershell + [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 + ``` + +### More Models + +See the [ZenMux model list](https://zenmux.ai/models) for all available models and detailed information. + +### Contact Us + +If you encounter issues, need help, or have feedback, reach out through: + +- **GitHub Discussions**: Submit issues and discuss in our community forum +- **Email**: Support channels available on [zenmux.ai](https://zenmux.ai) +- **Documentation**: Browse the [ZenMux docs](https://docs.zenmux.ai) for additional guides and references From 652bbce32c0d8e809b5f49e050cb7f0aede82f28 Mon Sep 17 00:00:00 2001 From: mingcheng Date: Sun, 15 Feb 2026 16:32:04 +0800 Subject: [PATCH 3/6] Update Hugo action to v3 and specify version 0.155.3 --- .github/workflows/gh-pages.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index 9c490a0..019c94c 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -18,9 +18,9 @@ jobs: fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod - name: Setup Hugo - uses: peaceiris/actions-hugo@v2 + uses: peaceiris/actions-hugo@v3 with: - hugo-version: '0.155' + hugo-version: '0.155.3' # Set a Hugo version to build your site extended: true - name: Build From fec8dbe9c005b06f5eaa7c36259957466bce668f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=98=8E=E5=9F=8E?= Date: Sun, 15 Feb 2026 16:32:56 +0800 Subject: [PATCH 4/6] Update content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- .../blog/using-ring-1t-with-claude-code-via-zenmux/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md index 302a35c..4297a30 100644 --- a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md +++ b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md @@ -578,9 +578,9 @@ This usually happens because old config files cached prior authentication info, export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" export API_TIMEOUT_MS="30000000" export ANTHROPIC_API_KEY="" # Clear to avoid conflicts - export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5" - export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.5" - export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.5" + export ANTHROPIC_DEFAULT_HAIKU_MODEL="inclusionai/ring-1t" + export ANTHROPIC_DEFAULT_SONNET_MODEL="inclusionai/ring-1t" + export ANTHROPIC_DEFAULT_OPUS_MODEL="inclusionai/ring-1t" ``` 3. **Reload environment variables**: From 0f992afef112d6d5879960b7322dbaacac0baac3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=98=8E=E5=9F=8E?= Date: Sun, 15 Feb 2026 16:33:06 +0800 Subject: [PATCH 5/6] Update content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md index 4297a30..53ad737 100644 --- a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md +++ b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md @@ -680,7 +680,7 @@ This usually happens because old config files cached prior authentication info, 2. **Check the model configuration**: - Search for "claude-code.selectedModel" in Settings - - Confirm it's set to `ring/ring-1t` + - Confirm it's set to `inclusionai/ring-1t` - Verify the model name format is correct 3. **Resolve environment variable conflicts**: From 5c56309352752d76d4ce988972612a02f194c4da Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=98=8E=E5=9F=8E?= Date: Sun, 15 Feb 2026 16:33:39 +0800 Subject: [PATCH 6/6] Update content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md index 53ad737..beeaa18 100644 --- a/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md +++ b/content/blog/using-ring-1t-with-claude-code-via-zenmux/index.md @@ -570,7 +570,7 @@ This usually happens because old config files cached prior authentication info, 2. **Confirm your shell environment variables are configured correctly**: - Check whether your shell config file (`~/.zshrc` or `~/.bashrc`) contains the full ZenMux configuration. Refer to [Step 1: Configure Shell Environment Variables](#step-1-configure-shell-environment-variables) above, and ensure it includes these key variables: + Check whether your shell config file (`~/.zshrc` or `~/.bashrc`) contains the full ZenMux configuration. Refer to [the shell profile configuration instructions](#option-1-shell-profile-configuration-recommended) above, and ensure it includes these key variables: ```bash export ANTHROPIC_BASE_URL="https://zenmux.ai/api/anthropic"