Claude Code

Claude Code 是 Anthropic 推出的智能终端编码工具，直接在终端中运行，通过自然语言完成代码生成、调试、重构和项目管理。搭配 Moniker 使用，无需 Claude 账号，以更低的价格使用顶级模型。

最省事的方法

装好 Claude Code 后，用 CC Switch 图形化配置，比手动改文件简单得多。下面的手动配置适合想了解细节或在服务器上使用的同学。

准备工作

1. 已创建一个 Claude 分组 的 API 密钥（推荐 claude-pro、claude-ultra、claude-max，见 分组选择指南）
2. 已安装 Node.js 18+，没有的话看 安装 Node.js

第 1 步：安装 Claude Code

打开终端（Windows 推荐 PowerShell），运行：

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

验证安装：

claude --version

显示版本号即安装成功。

下载太慢？

切换国内镜像后重新安装：

npm config set registry https://registry.npmmirror.com

macOS / Linux 提示权限不足？

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

Windows 用户：安装 Git

在 Windows 上运行 claude 如果出现：

Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).
If installed but not in PATH, set environment variable pointing to your bash.exe,
similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

这是因为 Claude Code 在 Windows 上内部需要 bash 环境。解决方法：

1. 下载并安装 Git for Windows，安装时保持默认选项
2. 关闭并重新打开 PowerShell
3. 再次运行 claude，即可正常启动 ✅

第 2 步：配置 Moniker

编辑 settings.json

配置文件位置（不存在就新建）：

系统	路径
macOS / Linux	~/.claude/settings.json
Windows	%USERPROFILE%\.claude\settings.json（即 C:\Users\你的用户名\.claude\settings.json）

写入以下内容，把 sk-xxxx 换成你的密钥：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://aimoniker.top",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

配置项	说明
ANTHROPIC_AUTH_TOKEN	你的 Moniker 密钥
ANTHROPIC_BASE_URL	https://aimoniker.top，不要加 /v1
API_TIMEOUT_MS	请求超时（毫秒），调大避免长任务超时
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	关闭遥测等非必要请求

跳过首次登录引导

创建 ~/.claude.json（Windows 为 C:\Users\你的用户名\.claude.json，注意它在用户目录下，不在 .claude 文件夹里）：

{
  "hasCompletedOnboarding": true
}

第 3 步：开始使用

在你的项目目录打开终端，运行：

cd your-project
claude

首次运行时选择信任该目录的文件访问权限，即可开始开发。

指定模型

在 Claude Code 中输入 /model 可以查看和切换模型。也可以在 settings.json 中为每一档指定实际使用的模型：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://aimoniker.top",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

可用模型以你所选分组在 模型广场 中列出的为准。

在 IDE 中使用

见 Claude Code IDE 插件，VS Code 和 JetBrains 都支持。

常见问题

修改配置后不生效？

• 关闭所有 Claude Code 窗口，重启终端
• 检查 JSON 语法（逗号、引号、括号）是否正确
• 实在不行，删除 ~/.claude/settings.json 后重新配置

启动后要求登录？

说明配置没有生效。检查 settings.json 的路径和内容，并确认已创建 ~/.claude.json。

推荐版本

建议使用 2.1.42 或更新版本，用 claude --version 查看。更新命令：

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

v2.1.69 已知 BUG

如果你使用的是 v2.1.69，需要在 settings.json 的 env 中额外加两项：

"ENABLE_TOOL_SEARCH": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"

报错"无可用渠道"？

当前分组不支持你选的模型（例如 claude-pro 不含 Fable 5）。换模型，或把密钥改到支持该模型的分组。

变慢、频繁报错？

看 分组状态监控，必要时在控制台把密钥换到其他 Claude 分组，本地配置不用改。

更多问题见 常见问题与报错。