Skip to content

Claude Code · macOS 使用指南

在 macOS 上安装 Claude Code 并接入 ooioo。

内测提示

CC 国产模型产品线内测中,可用模型以控制台「模型广场」为准。本页配置方法不受内测状态影响,产品开放后无需重新配置。

(一)安装 Claude Code

方法一:官方安装脚本(推荐,不依赖 Node.js)

bash
curl -fsSL https://claude.ai/install.sh | bash

方法二:npm 安装(需 Node.js ≥ 18,brew install node 可装):

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

安装完成后验证:

bash
claude --version

(二)接入 ooioo

方法一:配置文件(推荐)

编辑 ~/.claude/settings.json(没有就新建):

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ooioo.work",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Token"
  }
}

Token 在 ooioo 控制台 → 令牌 创建,见快速开始

方法二:环境变量

写进 ~/.zshrc(默认 shell 为 zsh):

bash
export ANTHROPIC_BASE_URL="https://ooioo.work"
export ANTHROPIC_AUTH_TOKEN="sk-你的Token"

改完执行 source ~/.zshrc 生效。

指定模型(可选)

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ooioo.work",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Token",
    "ANTHROPIC_MODEL": "模型名见控制台模型广场",
    "ANTHROPIC_SMALL_FAST_MODEL": "模型名见控制台模型广场"
  }
}

ANTHROPIC_MODEL 是主模型,ANTHROPIC_SMALL_FAST_MODEL 用于后台轻量任务,可以配一个更便宜的模型。

(三)开始使用

在任意项目目录运行:

bash
claude

首次启动如出现登录引导,选择使用已配置的 API(不要走 Anthropic 官方订阅登录)。输入 /status 确认 API Base URL 显示为 https://ooioo.work,即接入成功。

常见问题

现象原因与处理
401 / Invalid API keyToken 错误或已删除,到控制台核对;确认用的是 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY 走了官方
402余额不足或超预算拦截,见计费说明
模型报不存在模型名与控制台「模型广场」不一致
连接慢 / 流式中断检查本地网络与代理设置;持续出现请联系我们
/status 显示官方地址settings.json 路径/格式不对,或 shell 里有旧的 ANTHROPIC_BASE_URL 覆盖了它