gocode / claudecode

用 Go 实现的终端 AI 编程助手，能力与 Anthropic Claude Code 类产品相近：在本地工作区内对话、调用工具（读改文件、grep、bash、MCP 等），并对照本仓库中的 references/claude-code 快照做功能对齐（实现为独立代码，非官方产品）。

快速开始

• 环境：Go 1.25+（见 go.mod）。
• API：设置 ANTHROPIC_API_KEY 后进入在线模式；可选 ANTHROPIC_MODEL。未设置密钥时为离线提示模式。
• 运行：

go run ./cmd/claudecode
# 或
go build -o claudecode ./cmd/claudecode && ./claudecode

默认启动 REPL（与显式执行 claudecode repl 相同）。输入 /help 查看已注册的斜杠命令；Ctrl+D 或 /exit 退出。

• 版本：claudecode version

文档索引

文档	说明
docs/CLAUDECODE_GUIDE.md	使用指南：配置、会话、斜杠命令速查、安全与故障排查
docs/CLAUDECODE_TASKS.md	开发与对照：模块状态、相对参考实现的功能表、环境变量、规划与变更记录
docs/README.md	文档目录说明

仓库结构（节选）

cmd/claudecode/          # CLI 入口（Cobra）
internal/claudecode/
  cli/                   # 命令行解析
  repl/                  # 交互循环
  engine/                # 模型与工具循环（流式 / 非流式）
  tools/builtin/         # 内置 Agent 工具
  commands/builtin/      # 斜杠命令
  session/               # session.json 持久化
  permissions/           # policy.json + 环境变量
  services/mcp/          # MCP stdio 客户端
  envinfo/               # CLAUDE.md、AGENTS.md、.cursor/rules 等上下文
  state/                 # 会话级状态（如 todo_write 清单、会话标题）
references/claude-code/  # 可选：参考源码树（许可证见该目录）

开发与测试

gofmt -w .
go test ./...
go build -o claudecode ./cmd/claudecode

说明与合规

• references/claude-code 仅作行为与架构参考；本实现为自研，请分别遵守各自许可证。
• bash 工具会在本机执行 shell，生产环境请结合 policy.json 与团队规范使用（详见使用指南中的安全章节）。