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