initial commits

README.md

@@ -0,0 +1,52 @@
+# nexus-claude-api
+
+Local Anthropic-compatible API proxy for using AI Nexus Claude models with Claude Code.
+
+AI Nexus currently documents AWS Bedrock Converse API as the workaround while Anthropic Messages API support is unavailable. This service exposes local Anthropic-compatible endpoints and translates them to Nexus Converse requests.
+
+## Quick Start
+
+```powershell
+cd nexus-claude-api
+uv sync --extra dev
+uv run nexus-claude-api start --port 4141 --claude-code
+```
+
+Use the printed Claude Code command in the same shell.
+
+`ANTHROPIC_AUTH_TOKEN='dummy'` in the printed command is only a local Claude Code compatibility placeholder. Claude Code expects an Anthropic auth token variable to exist, but this local proxy does not validate it by default. It is not your Nexus key.
+
+## Endpoints
+
+- `GET /`
+- `GET /health`
+- `GET /v1/models`
+- `POST /v1/messages`
+- `POST /v1/messages/count_tokens`
+
+## Environment
+
+Credential lookup order:
+
+1. `--api-key`
+2. local `nexus-claude-api.local.json`
+3. `NEXUS_API_KEY`
+4. `AWS_BEARER_TOKEN_BEDROCK`
+
+For local hardcoded configuration, create `nexus-claude-api.local.json`:
+
+```json
+{
+  "api_key": "your-nexus-api-key"
+}
+```
+
+This file is ignored by git.
+
+The service binds to `127.0.0.1` by default and does not persist API keys.
+
+## Docs
+
+- [PRD](docs/PRD.md)
+- [Requirements Design](docs/REQUIREMENTS_DESIGN.md)
+- [AI Nexus Claude Documentation](docs/AI_NEXUS_CLAUDE.md)