Back to Details

free-code-claude-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

free-code Claude CLI

free-code Claude CLI

Skill by ara.so — Daily 2026 Skills collection.
free-code is a buildable fork of Anthropic's Claude Code CLI — a terminal-native AI coding agent. It removes all telemetry and phone-home callbacks, strips Anthropic's injected system-prompt guardrails, and unlocks 54 experimental feature flags that are disabled in the public npm release. It supports five model providers: Anthropic, OpenAI Codex, AWS Bedrock, Google Vertex AI, and Anthropic Foundry.
由ara.so开发的Skill — 2026年度技能合集。
free-code是Anthropic旗下Claude Code CLI的可构建开源分支，后者是一款终端原生AI编码Agent。本分支移除了所有遥测和回拨上报功能，去掉了Anthropic内置的系统提示词安全护栏，并且解锁了官方npm版本中禁用的54个实验功能开关。它支持五大模型提供商：Anthropic、OpenAI Codex、AWS Bedrock、Google Vertex AI和Anthropic Foundry。

Installation

安装

One-liner (recommended)

一键安装（推荐）

bash
curl -fsSL https://raw.githubusercontent.com/paoloanzn/free-code/main/install.sh | bash
This installs Bun if needed, clones the repo, builds with experimental features, and symlinks 
free-code
on your 
PATH
.
bash
curl -fsSL https://raw.githubusercontent.com/paoloanzn/free-code/main/install.sh | bash
该命令会在需要时自动安装Bun、克隆仓库、构建带实验特性的版本，并且将
free-code
软链接到你的系统
PATH
中。

Manual build

手动构建

bash
undefined
bash
undefined

Requires Bun >= 1.3.11

需要Bun版本 >= 1.3.11

curl -fsSL https://bun.sh/install | bash
git clone https://github.com/paoloanzn/free-code.git cd free-code bun run build ./cli

---
curl -fsSL https://bun.sh/install | bash
git clone https://github.com/paoloanzn/free-code.git cd free-code bun run build ./cli

---

Key CLI Commands

核心CLI命令

bash
undefined
bash
undefined

Start interactive REPL

启动交互式REPL

free-code
free-code

One-shot prompt

单轮提示执行

free-code -p "explain this codebase"
free-code -p "解释这个代码库的结构"

Specify model

指定使用的模型

free-code --model claude-opus-4-6
free-code --model claude-opus-4-6

OAuth login (runs /login slash command)

OAuth登录（执行/login斜杠命令）

free-code /login
free-code /login

Run from source (slower, no build step)

直接从源码运行（速度较慢，无需构建步骤）

bun run dev
undefined
bun run dev
undefined

Slash commands inside the REPL

REPL内的斜杠命令

/login          Authenticate with your chosen provider
/help           List all available commands
/clear          Clear conversation context
/compact        Compact context window
/memory         View/edit memory files
/login          认证你选择的模型提供商账号
/help           列出所有可用命令
/clear          清空对话上下文
/compact        压缩上下文窗口
/memory         查看/编辑记忆文件

Build Variants

构建版本

CommandOutputFeatures
bun run build
./cli
VOICE_MODE only (production-like)
bun run build:dev
./cli-dev
VOICE_MODE only, dev stamp
bun run build:dev:full
./cli-dev
All 54 experimental flags unlocked
bun run compile
./dist/cli
Alternative output path
命令输出路径包含特性
bun run build
./cli
仅包含VOICE_MODE（类生产环境）
bun run build:dev
./cli-dev
仅包含VOICE_MODE，带开发标识
bun run build:dev:full
./cli-dev
解锁全部54个实验功能开关
bun run compile
./dist/cli
可选输出路径

Enable specific feature flags

启用特定功能开关

bash
undefined
bash
undefined

Unlock ultrathink + ultraplan only

仅解锁ultrathink + ultraplan功能

bun run ./scripts/build.ts --feature=ULTRATHINK --feature=ULTRAPLAN
bun run ./scripts/build.ts --feature=ULTRATHINK --feature=ULTRAPLAN

Dev build with bridge mode added

开发版本构建，额外开启桥接模式

bun run ./scripts/build.ts --dev --feature=BRIDGE_MODE
bun run ./scripts/build.ts --dev --feature=BRIDGE_MODE

Full experimental unlock

解锁全部实验特性

bun run build:dev:full

---
bun run build:dev:full

---

Model Provider Configuration

模型提供商配置

Switch providers entirely via environment variables — no code changes needed.
仅通过环境变量即可切换提供商，无需修改任何代码。

Anthropic (default)

Anthropic（默认）

bash
export ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY"
free-code --model claude-opus-4-6
Available models: 
claude-opus-4-6
, 
claude-sonnet-4-6
, 
claude-haiku-4-5
Override model defaults:
bash
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"  # custom endpoint
bash
export ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY"
free-code --model claude-opus-4-6
可用模型：
claude-opus-4-6
、
claude-sonnet-4-6
、
claude-haiku-4-5
覆盖模型默认配置：
bash
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"  # 自定义接口地址

OpenAI Codex

OpenAI Codex

bash
export CLAUDE_CODE_USE_OPENAI=1
free-code --model gpt-5.3-codex
Available models: 
gpt-5.3-codex
, 
gpt-5.4
, 
gpt-5.4-mini
bash
export CLAUDE_CODE_USE_OPENAI=1
free-code --model gpt-5.3-codex
可用模型：
gpt-5.3-codex
、
gpt-5.4
、
gpt-5.4-mini

AWS Bedrock

AWS Bedrock

bash
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
bash
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"

Uses standard AWS credential chain: env vars, ~/.aws/config, or IAM role

使用标准AWS凭证链：环境变量、~/.aws/config、或者IAM角色

free-code

Additional Bedrock variables:

```bash
export ANTHROPIC_BEDROCK_BASE_URL="https://..."   # custom endpoint
export AWS_BEARER_TOKEN_BEDROCK="$TOKEN"           # bearer token auth
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1             # skip auth (testing only)
free-code

额外Bedrock配置变量：

```bash
export ANTHROPIC_BEDROCK_BASE_URL="https://..."   # 自定义接口地址
export AWS_BEARER_TOKEN_BEDROCK="$TOKEN"           # Bearer token认证
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1             # 跳过认证（仅测试用）

Google Cloud Vertex AI

Google Cloud Vertex AI

bash
undefined
bash
undefined

Authenticate first

先完成认证

gcloud auth application-default login
export CLAUDE_CODE_USE_VERTEX=1 free-code
undefined
gcloud auth application-default login
export CLAUDE_CODE_USE_VERTEX=1 free-code
undefined

Anthropic Foundry

Anthropic Foundry

bash
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_API_KEY="$ANTHROPIC_FOUNDRY_API_KEY"
free-code --model my-deployment-id
bash
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_API_KEY="$ANTHROPIC_FOUNDRY_API_KEY"
free-code --model my-deployment-id

Experimental Features Reference

实验特性参考

Build with 
bun run build:dev:full
to unlock all 54 flags, or pass 
--feature=FLAG
individually.
使用
bun run build:dev:full
构建即可解锁全部54个开关，也可以单独传入
--feature=FLAG
启用指定特性。

High-value flags

高价值开关

FlagWhat it does
ULTRATHINK
Type "ultrathink" in a prompt to boost reasoning depth
ULTRAPLAN
Remote multi-agent planning (Opus-class) via Claude Code web
VOICE_MODE
Push-to-talk voice input and dictation
TOKEN_BUDGET
Real-time token budget tracking and warnings
HISTORY_PICKER
Interactive prompt history picker
EXTRACT_MEMORIES
Auto-extracts memories after each query
VERIFICATION_AGENT
Validation agent that checks task completion
AGENT_TRIGGERS
Local cron/trigger tools for background automation
BRIDGE_MODE
IDE remote-control bridge (VS Code, JetBrains)
BASH_CLASSIFIER
AI-assisted bash permission decisions
BUILTIN_EXPLORE_PLAN_AGENTS
Preset explore/plan agent configs
TEAMMEM
Team-shared memory files with watcher hooks
COMPACTION_REMINDERS
Smart reminders around context window compaction
开关名称功能说明
ULTRATHINK
在提示中输入"ultrathink"即可提升推理深度
ULTRAPLAN
通过Claude Code网页端实现远程多Agent规划（Opus级别能力）
VOICE_MODE
按键通话语音输入和听写功能
TOKEN_BUDGET
实时Token用量追踪和告警
HISTORY_PICKER
交互式提示历史选择器
EXTRACT_MEMORIES
每次查询后自动提取记忆
VERIFICATION_AGENT
校验Agent，检查任务完成情况
AGENT_TRIGGERS
本地定时/触发工具，用于后台自动化
BRIDGE_MODE
IDE远程控制桥接（支持VS Code、JetBrains）
BASH_CLASSIFIER
AI辅助的bash权限决策
BUILTIN_EXPLORE_PLAN_AGENTS
预设的探索/规划Agent配置
TEAMMEM
团队共享记忆文件，带监听钩子
COMPACTION_REMINDERS
上下文窗口压缩的智能提醒

Environment Variables Quick Reference

环境变量快速参考

bash
undefined
bash
undefined

Authentication

认证相关

ANTHROPIC_API_KEY # Anthropic API key ANTHROPIC_AUTH_TOKEN # Alternative auth token CLAUDE_CODE_OAUTH_TOKEN # OAuth token via env (skips /login)
ANTHROPIC_API_KEY # Anthropic API密钥 ANTHROPIC_AUTH_TOKEN # 替代认证Token CLAUDE_CODE_OAUTH_TOKEN # 通过环境变量传入OAuth Token（跳过/login步骤）

Provider selection

提供商选择

CLAUDE_CODE_USE_OPENAI=1 # Switch to OpenAI Codex CLAUDE_CODE_USE_BEDROCK=1 # Switch to AWS Bedrock CLAUDE_CODE_USE_VERTEX=1 # Switch to Google Vertex AI CLAUDE_CODE_USE_FOUNDRY=1 # Switch to Anthropic Foundry
CLAUDE_CODE_USE_OPENAI=1 # 切换到OpenAI Codex CLAUDE_CODE_USE_BEDROCK=1 # 切换到AWS Bedrock CLAUDE_CODE_USE_VERTEX=1 # 切换到Google Vertex AI CLAUDE_CODE_USE_FOUNDRY=1 # 切换到Anthropic Foundry

Model overrides

模型覆盖

ANTHROPIC_MODEL # Override default model for session ANTHROPIC_BASE_URL # Custom API base URL
ANTHROPIC_MODEL # 覆盖当前会话的默认模型 ANTHROPIC_BASE_URL # 自定义API基础地址

Tuning

调优参数

CLAUDE_CODE_API_KEY_HELPER_TTL_MS # API key helper cache TTL in ms

---
CLAUDE_CODE_API_KEY_HELPER_TTL_MS # API密钥助手缓存TTL（单位：毫秒）

---

Project Structure

项目结构

scripts/
  build.ts              # Build script — feature flag injection lives here

src/
  entrypoints/cli.tsx   # CLI entry — Commander.js setup, arg parsing
  commands.ts           # Slash command registry
  tools.ts              # Agent tool registry
  QueryEngine.ts        # Core LLM query orchestration
  screens/REPL.tsx      # Interactive terminal UI (React + Ink)

  commands/             # /slash command implementations
  tools/                # Agent tools: Bash, Read, Edit, Glob, Grep, etc.
  components/           # Ink/React terminal UI components
  services/
    api/                # Anthropic + Codex API clients
    oauth/              # OAuth flows (Anthropic, OpenAI)
  state/                # Global app state store
  utils/model/          # Model config, provider routing, validation
  bridge/               # IDE bridge (BRIDGE_MODE)
  voice/                # Voice input (VOICE_MODE)
  skills/               # Skill system
  plugins/              # Plugin system
  tasks/                # Background task management
scripts/
  build.ts              # 构建脚本 — 功能开关注入逻辑在此处

src/
  entrypoints/cli.tsx   # CLI入口 — Commander.js配置、参数解析
  commands.ts           # 斜杠命令注册中心
  tools.ts              # Agent工具注册中心
  QueryEngine.ts        # 核心LLM查询编排模块
  screens/REPL.tsx      # 交互式终端UI（React + Ink）

  commands/             # /斜杠命令的具体实现
  tools/                # Agent工具：Bash、读取、编辑、Glob、Grep等
  components/           # Ink/React终端UI组件
  services/
    api/                # Anthropic + Codex API客户端
    oauth/              # OAuth流程（Anthropic、OpenAI）
  state/                # 全局应用状态存储
  utils/model/          # 模型配置、提供商路由、校验
  bridge/               # IDE桥接（BRIDGE_MODE）
  voice/                # 语音输入（VOICE_MODE）
  skills/               # Skill系统
  plugins/              # 插件系统
  tasks/                # 后台任务管理

Common Patterns

常用使用场景

Use ultrathink for hard problems

针对复杂问题使用ultrathink

After building with 
--feature=ULTRATHINK
:
> ultrathink refactor this authentication module to use JWTs
The keyword 
ultrathink
in your prompt triggers extended reasoning mode.
使用
--feature=ULTRATHINK
构建后：
> ultrathink 重构这个认证模块，改用JWT实现
提示中的关键词
ultrathink
会触发扩展推理模式。

Pipe files into one-shot mode

在单轮提示模式下管道传入文件

bash
cat src/auth.ts | free-code -p "find security issues in this file"
free-code -p "write tests for $(cat src/utils.ts)"
bash
cat src/auth.ts | free-code -p "找出这个文件中的安全问题"
free-code -p "为$(cat src/utils.ts)编写测试用例"

Run with a specific provider per session

单会话指定提供商运行

bash
undefined
bash
undefined

One-off Bedrock session without changing env permanently

一次性使用Bedrock会话，不会永久修改环境变量

CLAUDE_CODE_USE_BEDROCK=1 AWS_REGION=eu-west-1 free-code
CLAUDE_CODE_USE_BEDROCK=1 AWS_REGION=eu-west-1 free-code

One-off Vertex session

一次性使用Vertex会话

CLAUDE_CODE_USE_VERTEX=1 free-code -p "review this PR diff"
undefined
CLAUDE_CODE_USE_VERTEX=1 free-code -p "评审这个PR的差异"
undefined

Custom build for CI with minimal features

为CI定制最小功能构建

typescript
// scripts/build.ts accepts --feature flags
// Build only what you need for a headless CI agent:
// bun run ./scripts/build.ts --feature=VERIFICATION_AGENT --feature=AGENT_TRIGGERS
typescript
// scripts/build.ts支持传入--feature参数
// 为无头CI Agent仅构建需要的功能：
// bun run ./scripts/build.ts --feature=VERIFICATION_AGENT --feature=AGENT_TRIGGERS

Troubleshooting

问题排查

bun: command not found

bun: command not found

bash
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc  # or ~/.zshrc
bash
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc  # 或者~/.zshrc

free-code: command not found
after install

安装后提示
free-code: command not found

The install script symlinks to your PATH. If it's missing:
bash
cd free-code
ln -sf "$(pwd)/cli" /usr/local/bin/free-code
安装脚本会将软链接添加到PATH中，如果找不到的话可以手动添加：
bash
cd free-code
ln -sf "$(pwd)/cli" /usr/local/bin/free-code

Build fails on experimental flags

实验开关构建失败

Some of the 88 flags don't compile cleanly. Use 
build:dev:full
which only enables the 54 working flags. For broken flags, check 
FEATURES.md
for reconstruction notes:
bash
undefined
88个开关中部分暂时无法正常编译，使用
build:dev:full
只会启用54个可正常工作的开关。如果遇到失效的开关，可以查看
FEATURES.md
的重构说明：
bash
undefined

Safe full-unlock build (54 working flags only)

安全的全解锁构建（仅启用54个可正常工作的开关）

bun run build:dev:full
undefined
bun run build:dev:full
undefined

Authentication errors with Bedrock

Bedrock认证错误

Verify your AWS credential chain is working independently:
bash
aws sts get-caller-identity
先独立验证你的AWS凭证链是否正常工作：
bash
aws sts get-caller-identity

If this fails, fix AWS credentials before setting CLAUDE_CODE_USE_BEDROCK=1

如果该命令失败，先修复AWS凭证，再设置CLAUDE_CODE_USE_BEDROCK=1

undefined
undefined

Vertex AI auth errors

Vertex AI认证错误

bash
gcloud auth application-default login
gcloud auth application-default print-access-token  # verify it works
export CLAUDE_CODE_USE_VERTEX=1
free-code
bash
gcloud auth application-default login
gcloud auth application-default print-access-token  # 验证凭证有效
export CLAUDE_CODE_USE_VERTEX=1
free-code

Context window fills up quickly

上下文窗口快速占满

Enable compaction reminders and use the 
/compact
command:
bash
bun run ./scripts/build.ts --feature=COMPACTION_REMINDERS
开启压缩提醒功能，使用
/compact
命令：
bash
bun run ./scripts/build.ts --feature=COMPACTION_REMINDERS

Inside REPL when warned:

收到提醒后在REPL内执行：

/compact

---
/compact

---

IPFS Fallback

IPFS备份源

If the GitHub repo is unavailable, the full source is permanently mirrored:
CID: bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
URL: https://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
如果GitHub仓库无法访问，完整源码已永久镜像存储：
CID: bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
URL: https://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm