Skip to content
CC Switch WikiUnofficial Community Wiki

Not logged in, please run /login - Claude Code

Quick fix

Add hasCompletedOnboarding: true to ~/.claude.json and turn on "use custom Api key" in /config.

Symptom

Section titled “Symptom”
Error output
Not logged in, please run /login

Cause

Section titled “Cause”

Newer Claude Code versions introduced an onboarding flow and a subscription channel choice. Even with cc-switch writing ANTHROPIC_BASE_URL and the other environment variables into settings.json correctly, if the global config file ~/.claude.json lacks hasCompletedOnboarding: true, or use custom Api key is set to false in /config (that is, it goes through the official subscription channel), the client still ignores the custom API configuration and forces an OAuth login. A case error in the permissions field of settings.json (read instead of Read) also breaks config parsing and triggers the same login block.

Fix

Section titled “Fix”

  1. Add or change the hasCompletedOnboarding field to true in ~/.claude.json in your home directory. Create the file if it does not exist.

    // ~/.claude.json
    {
      "hasCompletedOnboarding": true
    }

  2. Start Claude Code in a terminal, run the /config command, and check the last item, use custom Api key — make sure it is set to true.

  3. Check ~/.claude/settings.json and make sure the permission names in the permissions.ask array are capitalized (change read to Read, for instance).

    // ~/.claude/settings.json
    {
      "permissions": {
        "ask": [
          "Read"
        ]
      }
    }

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
VersionUnknown
PlatformsWindowsmacOSLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why does changing the configuration in the cc-switch UI or settings.json not skip the login?
Because hasCompletedOnboarding, the trigger for skipping login, has to be written in ~/.claude.json, not in settings.json.
Having configured a third-party API, how do I switch quickly back to the official Claude subscription plan?
First clear the environment variables that are taken (on Linux run unset ANTHROPIC_BASE_URL; in Windows CMD run setx ANTHROPIC_BASE_URL ""), then create and switch to the official provider in cc-switch, and finally logout and login again.
Section titled “Related problems”
auth.json under .claude is forcibly replaced after a restart - CodexUpgrade cc-switch to the latest version, or turn proxy takeover off before signing in officially, so a stale snapshot cannot overwrite official credentials.5 issues mergedAPI Error: 401 authentication_errorCheck the API key field, Base URL, key type, and cc-switch version, so Claude Code actually reads a valid credential.7 issues mergedHTTP 401 Unauthorized - CC Switch AnthropicUpgrade cc-switch to a fixed build so it sends the x-api-key and anthropic-version headers Anthropic requires.2 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.