Claude Code

Claude Code 是 Anthropic 官方的编程 CLI，能在终端里直接读写你的项目文件、执行命令、跑测试。ModeXFlow 把它的 API 路径完全兼容化，只需要改两个环境变量即可接入。

前置

• 装 Node.js 20+ 和 npm
• 有一把分组为 Claude-Stable 或 Claude-ESpeed 的 ModeXFlow 令牌（怎么建）

安装

官方包

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

用 pnpm

pnpm add -g @anthropic-ai/claude-code

配置

方式 A：环境变量（推荐，跨终端会话保留）

在 ~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish 里加：

export ANTHROPIC_BASE_URL="https://api.modexflow.cc"
export ANTHROPIC_API_KEY="sk-你的-token"
# 让 claude 别去校验 Anthropic 官方的余额（我们是中转，不需要）
export ANTHROPIC_AUTH_TOKEN="sk-你的-token"

重开终端或 source ~/.zshrc 生效。

方式 B：仅当前会话

export ANTHROPIC_BASE_URL="https://api.modexflow.cc"
export ANTHROPIC_API_KEY="sk-你的-token"
claude

用起来

进入任意项目目录：

cd ~/your-project
claude

出现 REPL 后，就可以像跟同事说话一样发指令：

> 帮我把这个 react 组件的 useState 全部改成 useReducer
> 写测试，覆盖登录失败的 3 种场景
> 重构 auth.py 里的 login 函数，把 db 查询提取到单独的 dao 层

挑选模型

Claude Code 默认调 claude-sonnet-4-6。用不同模型：

# 启动时指定
claude --model claude-opus-4-8

# 或会话中切
> /model claude-opus-4-8

我们支持的所有 Claude 模型见 模型列表。

用「极速」分组降低费用

如果你频繁跟 Claude 反复迭代同一份代码/文档，强烈建议把令牌分组切到 Claude-ESpeed。这个分组的所有渠道都支持 prompt caching，命中缓存后 input tokens 只算 10-25% 费用。

在控制台改 Key 分组，约 60 秒内生效。改完再跑 Claude Code，看控制台账单里的 cached_tokens 有没有涨——涨了就是缓存生效了。

让 Claude Code 走 Git 提交

> 帮我用 git 把 src/auth 目录下的改动 commit 一下，message 用规范的 conventional commits

Claude Code 会执行 git add、git commit -m "..."。首次执行敏感命令时它会问你确认，可以选择「本会话内一直允许」。

断电/重启后继续

Claude Code 会把每次会话存到 ~/.claude/history/。重新启动进入项目，运行 claude --resume 就能续上上次的对话。

常见问题

Q: 报 401 Unauthorized?
检查 ANTHROPIC_API_KEY 是不是 ModeXFlow 的 Key（而不是 Anthropic 原厂 Key），并且 ANTHROPIC_BASE_URL 拼对了。

Q: 报 channel not found 或 无可用渠道?
你 Key 的分组不支持这个模型。改 Key 分组到 Claude-Stable 或 Claude-ESpeed。

Q: 请求半天没首字节，超时了？
Claude 长 prompt 首字节可能要 5-15s。客户端超时至少给 60s。Claude Code 默认已经足够。

Q: 用 claude update 升级失败？
claude update 会去 Anthropic 官方查版本，可能被中转拦截。改用 npm update -g @anthropic-ai/claude-code。

Q: 想撤销我上一步操作？

> /undo

Q: Claude Code 显示的余额跟 ModeXFlow 控制台不一致？
Claude Code 自己有个内部余额估算逻辑，会用 Anthropic 官方口径。以 ModeXFlow 控制台为准。

相关

• Codex CLI 接入 — GPT / OpenAI 系
• Gemini CLI 接入
• 用 CC Switch 一键切换多平台