CLI 配置教程

把 Claude Code、OpenAI Codex 两个命令行助手统一指向 Starsg,共享同一套网关、API Key 与用量视图。

重要开始前请先准备好在控制台创建的 API Key。如果还没有 Key,点击链接前往创建。

1. 环境检查

在终端运行 npm list -g --depth-0 确认 Node.js 已安装。如果提示 "command not found",请先按此教程安装运行 Claude Code、Codex 所需的 Node.js 环境,装好后重新执行该命令。

bash

npm list -g --depth-0

确认环境正常后,一次性安装两个 CLI:

bash

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest

重要:依次执行下面两条命令分别测试两个 CLI 是否安装成功。第一次运行时各 CLI 会在你的用户目录下生成对应的配置目录,后续步骤都依赖这些目录,这一步必须做。

bash

claude
codex

若终端出现对话界面、欢迎信息或可选项菜单,即表示对应的 CLI 安装成功。

重要:如果 claude 命令提示无法连接到 Anthropic 服务,请先点击 Claude Code 无法连接到 Anthropic 服务中的命令完成额外配置,再继续阅读后面单独的 CLI 配置教程。

2. Claude Code

打开 ~/.claude/settings.json (文件不存在则手动创建),写入以下内容:

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.starsg.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-abc...xyz",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

把 sk-abc...xyz 替换成在控制台创建的 API Key,然后在终端执行 claude,出现对话回复即配置成功。

提示注意,如果配置完仍然有报错问题,提示你需要登录,请看 Claude Code 无法连接到 Anthropic 服务解决。

3. Codex

编辑 ~/.codex/config.toml ,这里配置网关地址、默认模型与推理强度:

toml

disable_response_storage = true
model = "gpt-5.5"
model_provider = "novamaas"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.novamaas]
base_url = "https://api.starsg.ai/v1"
name = "novamaas"
requires_openai_auth = true
wire_api = "responses"

再把 API Key 写入 ~/.codex/auth.json :

json

{
  "OPENAI_API_KEY": "sk-abc...xyz"
}

提示很多人刚安装可能没有这三个文件,你需要手动去创建这三个文件,然后写入内容。

4. 测试对话

在终端分别运行 claude 或 codex ,任一命令能正常收到回复就说明接入成功。

扩展阅读：控制台 › API Keys·API 文档 › 快速开始