Claude Code 是 Anthropic 官方推出的命令行编程助手，可以在终端中直接使用 Claude 的强大编程能力。通过配置 Flum-API 服务，您可以获得：
简化配置提示：如果您不想注册 Claude 官网账号，建议直接查看下方的高级配置部分，使用 .claude.json 文件配置，可以完全绕过官网验证。
1. 安装 Claude Code
在终端运行以下命令全局安装：
npm install -g @anthropic-ai/claude-code
2. 配置 API 密钥
获取 API 密钥
- 访问 Flum-API控制台
- 在【令牌管理】栏目生成新的密钥
- 复制密钥备用
设置环境变量
在系统环境变量中添加 Flum-API 配置。
macOS/Linux
编辑 ~/.zshrc 或 ~/.bashrc 文件：# Flum-API 配置
export ANTHROPIC_API_KEY="sk-你的Flum-API密钥"
export ANTHROPIC_API_BASE="https://flum.store"
Mac 用户提示：在用户目录按 ⌘ + ⇧ + . 显示隐藏文件，使用文本编辑器打开 .zshrc 文件。
Windows
使用 PowerShell 编辑配置：# 编辑配置文件
notepad $PROFILE
# 添加以下内容
$env:ANTHROPIC_API_KEY = "sk-你的Flum-API密钥"
$env:ANTHROPIC_API_BASE = "https://flum.store"
3. 使配置生效
macOS/Linux
source ~/.zshrc
# 或
source ~/.bashrc
4. 启动 Claude Code
进入你的项目目录并启动：
# 进入项目目录
cd ~/Desktop/my-project
# 启动 Claude Code
claude
高级配置
项目级配置（推荐）
在项目根目录创建.claude.json文件，可以绕过 Claude 官网验证：
{
"apiKey": "sk-你的Flum-API密钥",
"apiBaseUrl": "https://flum.store",
"hasCompletedOnboarding": true
}
重要提示：添加 "hasCompletedOnboarding": true 可以完全绕过 Claude 官网账号验证，直接使用 Flum-API 服务。这样您无需：
- 注册 Claude 官网账号（注册困难，需要海外手机号）
- 担心 Claude 官网账号被封
- 进行任何额外的授权步骤
安全提醒：.claude.json 文件包含敏感信息，请确保：
- 添加到
.gitignore 中，避免提交到版本控制系统
- 不要分享包含此文件的项目压缩包
全局授权（不推荐）
如果没有配置hasCompletedOnboarding: true，首次使用时会弹出授权页面：
- 需要跳转到 Claude 官网进行确认
- 需要有 Claude 官网账号（注册困难且容易被封）
- 授权成功后返回终端继续
建议：强烈推荐使用上述 .claude.json 配置方法，避免 Claude 官网账号的各种限制。
使用指南
基本命令
启动后，Claude Code 会显示当前配置信息：
claude
# 显示 API Key 和 API Base URL
# 确认配置无误后选择 Yes 继续
**\
工作流程**
- 启动助手：在项目目录运行
claude
- 描述需求：输入你的编程需求或问题
- 交互对话：Claude 会理解上下文并提供代码建议
- 应用更改：确认后 Claude 可以直接修改文件
支持的功能
- ✅ 代码生成和优化
- ✅ Bug 修复和调试
- ✅ 代码重构建议
- ✅ 文档编写
- ✅ 测试用例生成
- ✅ 技术问题解答
**\
模型选择**
Claude Code 默认使用最新的 Claude 模型。通过 Flum-API，你可以访问：
| 模型 | 特点 | 推荐场景 |
|---|
| Claude 4 Sonnet | 编程能力最强 | 复杂代码任务 |
| Claude Opus 4.1 | 性能升级版 | 高要求编程 |
| Claude 4 Sonnet Thinking | 思维链模式 | 复杂推理 |
故障排除
常见问题
Show Unable to Connect to Anthropic Services
这通常是网络配置问题。请检查：
- 环境变量是否正确设置
- API 密钥是否有效
- 网络连接是否正常
运行以下命令验证配置：echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_API_BASE
这是因为没有配置 hasCompletedOnboarding。在项目目录创建 .claude.json 文件并添加：{
"apiKey": "sk-你的Flum-API密钥",
"apiBaseUrl": "https://flum.store",
"hasCompletedOnboarding": true
}
确保使用的是 Flum-API 的密钥，而不是 Claude 官网的密钥。在 Flum-Flum-API控制台 生成新密钥。
运行以下命令更新到最新版本：npm update -g @anthropic-ai/claude-code
Claude Code 支持所有主流编程语言，包括但不限于：
- Python, JavaScript/TypeScript, Java, C++, C#
- Go, Rust, Swift, Kotlin
- HTML/CSS, SQL, Shell Scripts
- 以及更多…
最佳实践
有效的提示词
好的提示：
"帮我重构这个 Python 函数，使其更高效并添加类型注解"
"这段代码有内存泄漏，请帮我找出并修复"
"为这个 React 组件编写单元测试"
避免过于宽泛：
"改进我的代码" # 太模糊
项目结构建议
- 保持代码库整洁有序
- 使用清晰的文件命名
- 添加适当的注释
- 提供项目 README
性能优化
提升响应速度
- 使用项目配置：
.claude.json 配置可避免每次验证，特别是设置 hasCompletedOnboarding: true 后启动更快
- 保持对话连贯：在同一会话中处理相关任务
- 明确需求：清晰描述可减少往返交互
成本控制
- Claude Code 按 Token 使用量计费
- 通过 Flum-API 可享受优惠价格
- 查看 定价页面 了解详情
Claude Code 结合 Flum-API 服务，为开发者提供了一个强大、稳定、经济的 AI 编程助手解决方案。无需昂贵的订阅费用，即可享受顶级的 AI 编程体验。
